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ABSTRACT 


This tnesis describes the detailea interface design and 
implementation oft tne Micropolis 12240 rigid disk storage 
unit into the AEGIS multiuser environment. At the onset of 
this work, the AEGIS development system consisted of an MEE- 
RG bubble memory, the REMEX Data Warenouse disk System, and 
Baur INTEL iSBC 86/12A single board computers. Tre 
Micropolis interface was accomplished utilizine tre INTEL 
8255 programmable parallel I/O port resident on one cf the 
AEGIS iSBC 86/12A computers. Tne iS#C £6/12A used for tne 
Euterface Can Still ve operated as an independent computer 
with all Micropolis disk operations being transparent to the 
user. reitero nejlls disk unit adds an, additional 35.6 
mezabytes or online Storaze to the AFGIS system. 
Utilization of the Micropolis disk system as a software 
develooment storage media will rree tne REMSX Data Werenguse 


for storage of radar data to emulate the SPY-1A radar. 
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I. INTRODUCTION 


eM dumm ey iy ee ee ee m 


Be DISCLAIMER 

Many terms used in tnis tnesis ere registereac trademarks 
ore commercial products. Rascherzrncen attempt to Cite Sach 
mmeividual occurrence of a trademark, all registered 
npgdemarks appearing in tnis tnesis will be listed below, 


following the firm holding tne trademark. 


mane corporation, Santa Clara, California: 
INTEL MULTIEUS INTELLEC MDS 
VCS PSEC 
E e Cyber/Metrixs Incorporated, Dublin, Calitrornia: 


Buppl-Boara MBB-2RY 3upbl-3oar4 


CELL -O Corporation, Irvine, California: 


REMEX Data Warenouse 


Digital Research, Pacific Grove, California: 


EM ODDO 


Em ropolis Corporation, Chatswortn, California: 


Elrcropolis 


B. GENERAL DISCUSSION 
hnc MhGolS weapons system simulation project is an 


ongoing study currently being conducted at the Naval 
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Postgraduate Sono Ice primary objective of this study is 
Momeinvestigate the feasibility of replacing tne present, 
four-processor AN/UIK-7 mainfrane computer witn a multiple 
Meecrocomputer based architecture. 

ince primary mission ot the multiprocessor system is to 
Mes computer control tor the SPT-IM radar system. Inis 
System collects large amounts of data concerning target 
detection and acquisition which must be processed in real- 
time. NK nhcpoecomputerebssedc"sysiem caen provide vine" same 
EE processing In Teal-time only if more than one 
processor is used and tne computations are performed 
eoncurrently. 

moms, bie ww tirst loeical step or tne ALGIS study was to 
fede y ad Vieble microcomputer and design an efficient 
Operating system capable of managing concurrent processes. 
detailed design of such an cperating system was presentea 
by Wasson in 198£ [Ref. 1]. Tnıs design was based on tne 
INTEL 1SEC 265/12A microconputer. This is a single board 
Eurer obased.on tne INTEL 8986 16-bit microprocessor. Tne 
Operating system,  MCORTEX, was implemented usine  wasson's 
design and refined many times. Kıinsefelter demonstrated tae 
EST truly efficient implementation of MCORTEX with four 
i¡SBC 86/12A’s in June of 1982 [Ref. 2]. 

Because COR ID. was a very specialized manager of 
concurrent processes, 1% was not an operating system well 


suited for program module development. Thus, the next 


1il 





cal step Of the project was to identify an operating 
uenia cou ld be. easily integrated into tne same 
hardware utilized by MCORTSX. Tnis would allow tne same 
Deren tO De used for both signal processing erulation by 
MCORTEX and as a software development tool. CP/M-86, 
Beweloped ty Digital Research tor use with tne INTEL RC EG 
Be ronrocessor, was Chosem for this purpose. ars choice 
MHEN tneomar)imumuin fleribiläry in thats this operating 
Syotem could 5e user con?*ieured for different or -haneine 
Herdware environments. 

MicesGandalor began the Inteeration process ty roditylne 
mas Basic Input/Cutput System (BIOS) or CP/M-S6 ror use on 
an INTEL “DS system. This was demonstrated in June of 19381. 
(Ret. 2] 

Eran dr Neure ld continued (ne integration process hy 
addine a bubble memory to tne MULTIBUS and again altering 
the BIOS to reflect the current nardware |Ref. 4]. Due to 
Meco voletile nature 5? a bubble memory, it was used in 
Eus application to store tne CP/M-B5 operatinz system. 
mays permitted a fast, *asy netnod of downloadire tne 
Operating system into random access memory (RAM) when power 
was applied to the system. 

Since the Klinefelter demonstration employed simulated 
processes, it was necessary to develop a method by which tne 


SPY-1A radar could be emulated in real-time. A nard disk 





drive, interfaced tnrougn direct memory access (DMA), was 
Mare minedi suitable for this purpose dueto its nien speed 
and large storage capacity. It was also zzersisezea 
desirable to make maximum use of tne available nardware wnen 
the system was beine operated in the software development 
mode. This required tnat each singie board computer nave 
I ceispaboility of Supporting an independent user. These two 
Eonespts were brouent to&etaer and demonstrated wita a four- 
board, multi-user system by Almquist ana Stevens in Decenber 
E2. (Ref. 5] 

SO nat ne system stili ilaczred áa capability of 
storing software for future rerinemert. Tnis tnesis 
completes tne program development system by presenting the 
are interface desien and software implementation of tne 
NS ropolis arsa drive into tie umultisuser system as 


lr Eloped by Almquist and Stevens. 


EE FORMAT OF THESIS 

Cnapter I gives a general overview of tne AEGIS research 
effort. It also provides a general developmental history of 
EN Uroj9cv and explains why line research work accomplisned 
by this thesis was essential to the project. 

Chapter II addresses tne system arcnitecture. Detaled 
Euscussion is given ot all major hardware components as this 
was the existing hardware environment inte which the 


Prcropolis disk drive had to be interfaced. 
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Chapter III describes the details of the AEGIS multiuser 
systen software. Tne standard CP/M-86 operating system is 
discussed in moderate detail. Aesomcovercd in this chapter 
is a powerful medification to CP/M-86 that was ceveloped 
during prior work. Tois modii cation provides a simple and 
efficient metnoc for altering the nardware environment 
Supported by the operating systen. 

The hardware interface developed for the Micropolis 1isx 
erstem is presented in Chapter IV. rizst, the details of 
the requirements imposed on the desien of the interface Dy 
the Micropolis controller are vresented. HTS r1sc7followed 
DNI cocevelopmepnt oot e functional interface to meet: tnose 
requirements. 

Chapter V presents tne software implementation of the 
Meeeronel!iS inte the GOP/M-B6 operatine system and Chapter VI 
mummarizes tne development work accomplished during this 
tnesis. iveiudec in Cnapter VI is a comparison of tne disk 
access times requirea by tne REMEX Data Warehouse (a DMS 
marerteced nard disk) and tne Micropolis disk system (a 


programmed I/O interfaced hard aisg). 
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Pipes (STEM ARCHITECTURE 


—— | (m u Gm un GE un Gen un ee EEE Ge Em 


As stated in the introduction, tne desien of the MCORTEX 
cperatinrng system and the software development system was 
based on tne INTEL iSBC 86/124 single board computer and 
various peripneral components. Plezure 2,1 depicts thea 
muverconnection of vnese components as they existed at tne 
onset of this research effort. In the patrastapis that 
follow, a description of each component, as well as its 
mole an the overall system, is given. An ermaustivye 
mecerintion of  €ach device can be found in tne cited 


Rererences. 


me INTEL 8088 

Tne INTEL 22826 is a nign pertormance, general purpose 
ES- pit microprocessor. Ie iSi tnaa Foundation M onw eN tis 
MeGcls deévelopmentel system is built. never To eiileure 272 
Ei 2eneral overview of its internal Structure and 
Organization. Tnis section is intended toO. vive ‘general 
Knowledge about this device. A detailed description can 


found in [Ref. 6l. 
AS can be Seen in Figure 2.2, tnere are eignt 16-bit 
general purpose registers. Four of tnese are byte or word 


addressable and are referred to as ‘tne data group. Tne 
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Figure 2,1 System Configuration 
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EXECUTION UNIT (EU) BUS INTERFACE UNIT (BLU) 


ADDRESS BUS 
GENERAL [CH CL 
PURPOSE 
REGISTERS 
AAA 


REGISTERS 
ALU DATA BUS 


(16 BITS) 


TEMPORARY 
REGISTERS 


INSTRUCTION 
QUEUE 


Figure 2,2 General Internal Organization of the 8086 
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remaining four are only word adaressabdie and are rererrei as 
“tne pointer and index group. 

The flags register is 16 bits wide and consists of 
nine usable status bits. Tne remaining seven are undefined. 
The nine hits are divided into six status flaes and three 
control flags. Tne status flags are set oy the B08BO6 as tne 
Mert ort arithmetic or logical operations. Roe we COT foul 
flags are set through programmed instructions. ot 
eati cular importance lls tne IF control tlags. Epis tlae vs 
used to enable/disable maskaoble interrupts and must be 
uu pseriy sev Tor the system to function correctly. RSE 
or interrupt-enable flag is discussed in greater detail ir 
meetlon 4 of this chapter. 

2. Segment Registers 

IPRC UCA Aedes has SEPMNENLT reglsters and tne 
memoir cal literature discusses segmentation as related to 
moe microprocessor, Is oa ua NOt be confused with 
segmentation as is generally defined for operatine systems. 
The operating system definition supports the ideas of memory 
Management and segment access checks tut ine 80986 nas no 
Special hardware taat supplies tnese functions. However, 
addressing is seement-lixwe in that it is two-dimensional. 

Physical addresses are generated from two 16-bit 


values: 3 base and an offset value. Tne pase value is 


shifted left four bits and the offset is added Uo CT Was 
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mat ted version to drrive avt a pnysical address. As en 


example, consider tne followine: 


EQ00 —- BASE VALUE 

ZAAA -- OFFSET VALUE 
Wnen tnese two hexídecimal values are added as described 
above, the result is: 

E££0€9 -— SHIFTED BASE VALUE 

2AAA -— OFFSET VALUE 

Bowne =— PHYSICAL ADDRESS 
It is the segment registers tnat supply the base value. 
mors mnetnod of addressing results in a 2@-bit address or a 
one megabyte address Space. 

SHOWO sin Figure 2.2 are four sesrert registers. 
Bach are 16 bits wide and give tne 8086 access to 64 
Kilobytes of memory. Assuming they are eacn set to 2 
different 64K base, tnis will zive tne CPU access to a 
maximum of  256K bytes of memory at any inStant of time. 
Because the segment registers are accessinle to tne 
Se tWare, they can be programmatically altered to any value. 
Thus allowing addressing tnrougnout the entire one megabyte 
mange . 
Waich segment register is used anc now tne offset 

meen 15 obtained depends upon tne instruction currently 
being executed. Tne CS or code segment reeister points to 


Bier current code seement. All executable instructions are 


r9 





mie amine GaSe ScemMent.s lneretore, tne address of tne next 
mestruction is computed using the CS register aS tne base 
and the instruction pointer (IP) as tne offset. All stack 
operations utilize tne stack segment (SS) rezister as tne 
base and the stack pointer (SP) as the offset. Tne data 
segment (DS) register and tne extra segment (ES) register 
have no explicit offset register associated with thom. Tris 
value is software controlled by supplying ore of tne 
messt=65S in the pointer and index group as a part ot tne 
ios truction. Program variables are generally placed in tne 
memory space accessible by tnese two seement registers. 
3. Execution and B3us Interface Units 

Ide Arge Lor ripure 2,2 is used to indicare 
two separate processing units within tne 2886: the execution 
unit (EU) and bus interface unit (BIU). Botn of tnese units 
operate independently. | 

Bie oC = 1S responsiole tor performing all bus 
operations tor tne EU, It generates 2¢ bit adaresses by 
Combining the segment and offset values in its own adder and 
Meansters data to and from the EU on tne ALU data bus. foe 
EIJ also fetches instructions for the EU and stores them in 
NU sir byte instruction yueuve. Tnis “Guenue mazes İt 
possible tor the BIU to ‘prefetch instructions during any 
Spare bus cycles. 

Tne EU is responsible tor executing all instructions 


and for transfering data and addresses to tne FIU. It also 
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maintairs the general purpose and flags registers. Eecause 
tnere is no connection from tne EU to tne system tus, jit is 


isolated from the outside world. a dq instructions to be 


executed are fetcned from tne BIU's instruction queue. In 


(D 


the event that the queue is empty, tne SU simply waits for 
mene BIU to place an instruction in tne queue. 

Tnis type On arcnitecture allows extensive 
overlapping of instruction fetcn with execution. The result 
EM T Tne Lame regulredato teren instructions becomes 
nearly transparent to the EU since it works on instructions 
E Nave beep prefetcned. DRY S, Coupled tran a So MEZ 
COCK, gives tne 84858 tne hign speea necessary ror the 
AESIS implementation. 

4. Interrupt structure 

ae 2 850 nasS provisions for up to 256 different 
MARU pos numbered Troms tO 255. Vhen an interrupt occurs, 
BEXESCPU must transfer control to a new proeram location trat 
Mans the necessary programmed instructions to service 
Mest interrupt. Tuomo lues are necessary to effect the 
Ester: tne code segment in which tne interrupt routine is 
Mia ted and te instruction pointer tor the routine. These 
values are located in a table trat begins at absolute zero 
in memory and extends to 3FF hexidecimal. Peren to RIEN 
Eo. RocEPnhormyat on needed for esen interrupt routine 


Eu uples four consecutive bytes in tnis table. Tes DUM 


=ı 





I< — 16 pits —>| 


TYPE O INTERRUPT IP OFFSET 
VECTOR ———— 
DIVIDE ERROR B CS ADDRESS 
TYPE 1 INTERRUPT 
VECTOR 
SINGLE-STEP 
TYPE 2 INTERRUPT 
VECTOR DEDICATED INTERRUPT 
NON-MASKABLE VECTORS 


0000:0000H 


:0004H 


:0008H 


:000CH 


:0010H 


:0014H 


RESERVED INTERRUPT 
VECTORS FOR 
COMPATIBILITY WITH 
INTEL PRODUCTS 


USER AVAILABLE 
INTERRUPT VECTORS 


Figure 2.3 Interrupt Vector Table 
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ENnopDiled o withoa type code wnen an interrupt occurs. Tnis 
value is automatically multiplied by four to determine tne 
correct position in tne table from wnicn to obtain th Cs 
and IP values. The current CS, IP and tlags register values 
are pushed on tne stack and the new CS and IP values are 
loaded. This completes the transfer of control. Born tne 
values in tne interrupt table and the interrupt routines 
E user Supplied “and must te placed in memory before tne 
mererrupt Can be permitted to occur. 

How Fine processor is supplied witn tne type coce 
cited above depends on tne metnod used to generate tne 
marerrupt. These can be software or hardware generated. 
Beraware interrupts are subdivided into two categories: 
masxable and non-maskable. Maskable interrupts are enabled 
EN !cdbiISd by setting or clearing tne IY flag. “nen tre 
CPU acknowledges a MaskatCle interrupt, it is tne 
responsibility of the hardware requesting the interrupt to 
Blace the type code on the bus for use by tne CPU. 

Non~maskable interrupts cannot de disablec. In the 
OT. a non=maskable interrupt, tne CPU automatically 
mostens it a type code or 2. Thus, a type code need not de 
supplied. 

Software interrupts can be invoked by executing the 
"INT n" instruction; where "n" is a number from Q to 255. 
Bernie case, the type code is an explicit part of tne 


NS truction. Taeyacan also oc -ur Dy Creatine a fatal error 
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NDS ot prosrem execution,  sucn as a divide ty zero 
or overflow error. The CPU will then use a predetined type 
we as depicted in Figure 2.3. 


The 8086 does not generally control the devices that 


Same Cause interrupts. This makes simultaneously occurring 


Macerruptus possible and therefore, GE MEUDUSMPUDLS “are 
prioritized. shown in Figure 2.4 is the interrupt 
Processing , sequence used. TAIS EAI eUre mndi cates that 


software generated interrupts ate the highest priority. 
Non-masxable are tne next rienest and maskable are the 
lowest. 

The interrupt structure discussed above plays an 
Important Polen cue = cevelopment of tne Mie FO pO 11S 
Bnrerface design. A general understanding of this structure 
EN n essential prerequiste to an understanding of both tne 
detailed design presented in Chapter IV and tne software 


implementation presented in Cnapter T. 


EEROTEE iS5C 986/124 

The 153C 86/12A is a complete single board computer. It 
EN -ci 35 tne central processing node or tne AFGIS 
multiprocessor system. The board includes” tae 6986 16-b1t 
meu, O44 bytes of RAM, a serial communications interface, an 
INTEL 8255 that supplies three proerammable parallel I/0 
ports, an INTEL 8253 programmable timer, an INTEL 82594A 


By inrerrupt Controller, MULTIBUS interface control 
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COMPLETE 
CURRENT 
INSTRUCTION 


PUSH FLAGS 
SET IF-0 






INSTRUCTION 


POP FLAGS 


Figure 2.4 Generalized Interrupt Processing Sequence 
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RNE UIC Dase rpansion drivers tor intertace with other 
EULTIBSUSMEInterface-compatibie expansion boards. Provisions 
are also made for installation of up to 16K bytes of EPROM. 
The current system orly utilizes EK oytes or EPROM on eacn 
board. 

The onboard 64K bytes of RAM can be dual-ported in 
segments of 16K bytes tnus maxing it accessible not orly to 
me local CPU but also to tre MULTIBUS. When dual-ported, 
Me SRAM can be switch-and-jumper configured to any 128K byte 
segment of the one megabyte address spece relative to tne 
MUSTIBUS. Local addresses are always fixed retween ¢UCUH 
and FFFFH regardless of tne MULTIBUS address the board is 
Bomwrieured for. iis system was desienea for independent 
Operation by each SBC and therefore, no RAM is dual-ported. 
To make the RAM inaccessible to the MULTIBUS requires a 
jumper between E112-E114 on eacn SEC. The toard does not 
ENS tactory equipped with tnis jumper and its existance 
Meet be verified before proper operation of the system can 
Be insured. 

Bien ioBC comes factory contieured with jurpers betweer 
E1Q3-E194 and El25-E145S. Tnese jumpers route the bus clock 
constant clocx sienals to tne MULTIBUS. As snown in 
Meure 2.1, several SBC's are connected to the MULTIBUS 
Bnmyerface. none Ot These 15 required to supply the 
clock signals to tne MULTIBOS. All otner boards must nave 


tne El23-E104 and E1U5-E1¢5 jumpers removed. 
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Me Spec la lcontieuratiors are necessary for tne 
iSBC 86/12A boards. For a complete discussion cr user 


Metiorns and factory defaults for tnis board see |Ref. 7]. 


C. MBB-89 BUBBLE MEMORY 

The MBB-89 Bubbi-Board is a memory storage device that 
EN ina t1ole with all €-b1t and 16-bit microprocessors 
Bene INTEL MULTIBUS architecture. The board provides 
moproximately 90K bytes of non-volatile memory as well as 
311 required MULTIBUS interface logic. 

IMertrace with the M8B-S9 controller is accomplished 
tnrougn memory mapped I/O and requires sixteen user-cefined 
locations in the MULTIBUS one megabyte address Space. These 
addresses correspond to controller registers tnat are used 
to read status, set board configurations and perform 
read/write operations. Rae current coñfizuration uses 
MULTIBUS addresses beginning at 82009H4. Tnis requires tnat 
Seiten S in S2 on the Bu p pl Roa Td be set to on ard all 
aers in S2 be set to orf. All switcnes in Sl must de 
Er to orr”. 

Tne bubble memory appears to tne system as a simple 9£x 
byte disk drive. All read/write operations to this devices 
pees aCcOmplished ir tne same manner used for any other disg 
Sea and require no special user invoked functions. Dus 
EN DSTty use in tae system as depicted in Figure 2.1 is as a 


non-volatile storage medium from whicn to load the oreratine 


et 





systen into RAM, Koreısecompleterdiscussion or the MBE=89 


Bubbdl-EFoard implemetation to tne system see [Ret. 4]. 


D. REMEX DATA WAREHOUSE 
1. Subcomponents and Storage Capacity 

The REMEX Data Warehouse is a mass storage unit 
containing two floppy disk drives (single or double-sided, 
single or double density) and a Winchester technology fixed 
disk drive. AGawpvonaiwiy., aaa MmeCaYyUemicronroces¢sor coupled 
with onboard firmware 1s the mechanism used to Service all 
erives. 

The fixed disk is a 14 inc1 enclosed disk system 
Bomsistine of two recordine surfaces. Each surface has two 
Beccording heads. Each nead can access 217 usable tracks 
e Uu track contains 39 5l2=byte sectors. Tals ves 
Beem Dead access to approximately 4 megabytes of storage and 
peeves the disk a total storage capacity of 16 megabytes, 

The two floppy drives are switcn-selectable to 
nandle SR Single or Gouüle €ensity . In TETS 
Buplementation, Single tensity, Standard IRM FM encoding is 
employed. 

2. MULTIBUS Intertace 

The REMEX Data Warenouse is interfaced to tne 
MULTIBUS via tne MULTIBUS Interface Card assembly supplied 
wich the unit. This assembly contains all tne necessary 


momerol,  bufferine and MULTIBUS interface 1ogic required to 
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interface witn tne nost system. MERO SACO MIC Tes "WITA 
the assembly using programmed I/0. Communications trom tne 
assembly to tne nost is via DMA. The interface acts as a 
bus master in the DMA mode and as a bus Slave in the 
programmed I/0 mode. 

The controller requires 4 I/O port addresses tor tne 
nost system communications. These are used to obtain status 
pimoe pass command information. [EEE 72, 7l, 
72 and 73 hexidecimal are used but these can be altered by 
Enanegeinge tne appropriate switcnes on tae MUITIBUS Interface 
Card assenbly. 

eeesystemssceonfieuration? in this implementation 
utilizes tne REMEY Data Warenouse as a program storage 
media. However, as alıuded to In the introduction, it is 
Ersci»ned that this hard disk drive will te used for 
Euorasc of track data im the SPY-1A radar emulation erfort. 


For further informaticn on tne REMEX consult [Rer. 8]. 


Es iCS-80 CHASSIS 

moe 16520 industrial chassis is MULTIsBUS—-corpatible anc 
EXDports a nodular microcomputer development system. It 
Bmaedjsts of four four-sict iSPC 524/5814 Caracages, four 
mens, d power supply and control panel. HAER ONTROL panel 
contains an on/off/lock xey switch, reset and interrupt 


pusnbuttons and various LED's. 
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oeeo ination of MULTIBUS-compatible plue in boards 
can be installed. A maximum of four boards can be placed in 
the iSBC 6@4 Cardcage. Additional iSBC 614 Cardcazes car be 
added to tne chassis tnrough an expansion interface supplied 
with tne system. Poe wracoragory system utilized in support 
of tnis tnesis consists of a single iSEC 6¢@4 Cardcage and 
Miree iSBC 614 Cardcages. Tnis gives a total capacity of 16 
Board slots. These cages provide tor both INTEL MULTIBTS 
master and slave boards. From the front panel, tne slots 
meemnimoered 1 to 16 from left to rignt. ell Toca muntered 
slots are configured for master boards and all even-numbered 
Sots are configured for slave boards. 

Because more than one bus master can be placed in tne 
cnassis, a priority resolution scheme is required to resolve 
ENLTIBUS access contention. Tgresscneme can becogersted Yn 
either the serial or parallel mode. In tne system of Fieure 
met, the chassis is operated in tn? parallel mode witn an 
external random priority network tor bus access resolution. 


For more irformation see [Ret. 9]. 


fee COMMON MEMORY 

Ehe common memory depicted in Figure 2.1 is a simple 42K 
Byte, MULTIBUS-compatitie PAM board. can be “switch 
configured to any address in the one megabyte Multibus 


anness space. Ceac ent configuration, it occupies 


5% 





addresses E20248E trirouen E?FFFE. The board is expandable to 
64K bytes of RAM. 

SSA rom true discussion on the 1580 €6/12A trat the 
RAM of all SBC’s in the system is jumper configured to be 
@ecessible Only to the local CPU. Tolo medr that neither 
the bubble controller aos” the REMEX controller can 
communicate directly with any ISEC, Tneretore, all 
read/write operations with these two devices is accomplisned 
vía the common memory. Tne tecnniyue usec to cocrcinate 
mois ertort is a Software one and is discussed in detail in 


the next Chapter. 


NE NICROPOLIS DISK DRIVE 


(0 


DnogMNCnODOIIS disk system" (not depicted in Figur 2 i) 
is He ete ner nen fixed disc drive with an integral 
Neon troller  boari. It consists of five data surtates with 
BN LdqCcÉS per surface.  Eacs track contains twenty-ftour 512 
Byte sectors. This gives a 35.6 megabyte formatted storage 
capacity. 

nec tro Ller boe consists of aeZ-8¢ microprocessor, 
mermware in PROM, and tne necessary cortrol logic and 
buffers to provide a variety of features. The features 
employed Ai caca tallis of — the Micropolls interface 


acComplisned as a result of this thesis work are ovresented 


mrecnhapters IV and V. 


oul 





Pll OS TES TEM OSO FAA RE 


The Micropolis interfacing work consisted cf two pnases: 
IErnardgwdrewnterface desiegzn and the software interface. 
Before either could be accomplished, it was necessary to 
understand both tne existing system architectures ani 
Software. Tne wast §"GRap ver addressec (et architecture. 
Therefore, this chaptar presents the details ot the AEGIS 


developmental system software. 


MC P/ M-96 OPERATING SYSTEM 
1. General Discussion 

CP/M-B6 is tne operatine system used in tne ARGIS 
Software development system. IU US a commercially 
distributed operating system developed by Digital Research 
ror use wit a single INTEL 8@86 based microcomputer. It is 
Sapplied on two single sided, single density, eignt inca 
meoppy disks. Taelnoedasonztneserdäiskertes is tne operating 
system (CPM.STS), an 8885 assomtler (ASMH6.CMD), the Dynamic 
Machine Language Denugger (DDT36.C*D), an editor  (ED.CMD) 
ana various recontizuration and file nandling utilities. 

The CP/M-86 operating system can be user configured 
EUN t any hardware environment. As it is snippea, tne file 
DSSS is configured for 32K bytes or RAM, a keyboard, a 


EucCenodevice, an INTEL iS8C 224 Floppy Disk Controller ana 
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SI mraideesehiaityeinteri:aced printer. Tne détails of tne 
CP/M structure and tne reconfiguration procedures are 
discussed below. Sor O pma Lion On the entire CEYN-55 
environment and capabilities see [Z82et. 12-12]. 


2 Structure 


— a ee LUE, E, mese EST 


Tne CP/M operating system can te viewed as occupying 
three distinct levels ofr abstraction. kereporo 2igure 3.1. 
Applications programs invoke system functions tnrougn the 
Basic Disk Operating System (3D0S) module and do rot 
communicate with any cther module. Dae ELOS PS ross 
Services requested by applications programs and all general 
file and disk management functions. All Nardvare dependent 
functions required by the BDOS are requested through tne 
Basic Input/Output System (BIOS) module. Tne BIOS module is 
Ehe only one that communicates with the hardware. The 
Console Command Processor (CCP) shown is used to process 
Aso le commands and provides the user interface ir tae 
Husegce of an applications program. 

succ | allo mariwdre dependent functions are located 
in the BIOS module, tre system hardware configuration must 
pe reflected nere. A skeletal BIOS (BIOS.AB6; is provided 
EN Source code format for this purpose. The CCP and BDOS 
modules are providea as a Single nex file (CPM.HES). THis 
Buc requires no modification but is necessary for tne 
adaption/recontizuration process described in Section 4 


below. 
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BDOS 
(LEVEL 2) 


APPLICATIONS PROGRAMS 
(LEVEL 3) 


Figure 3.1 CP/M-86 Levels of Abstraction 
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5. Bootstrapping CP/M 

Loading CP/M into RAM from a Standard single aensity 
EUODpy disk requires e two step procedure. Ene soot ROMS 
which receives control when tne system reset outton is 
Memressed, must load a loader program from tne reserved 
we tem tracks on the disk into RAM and pass control to it. 
eae loader is taen responsibie for loading tne operating 


Men trom the disk into RAM and passing control to it. 


1115 


ps 


EE wo Step procedure Lfserequired because tne oper 
system is too large to fit on tne reserved system tracks. 
Mmererore, adaption of CP/M to à system otner tnan tnat for 
Speco $t is commercially distributed requires modification 
mom these three software components. 
x Genera] Adaption Procedures 
nee Oro r OGL eine the adaption process i5 in tse 
development of the hardwareedrivers for tne BIOS nodule. 
The BIOS can be classified as performing three types ct 
functions: nardware Dupridication/rewnitieliszariom, 
character I/O and disk I/O. DHeetumeotloOns are contaire in 
2l subroutines witnin tne module. The PIOS accesses the 
subroutines tarouga a tarle tnat nas individual jump vectors 
Mae entry point of each subroutine. This i$ shown in the 
Eperatinge system memory map in Figure 3.2. Tne actions tnat 
EE dre place upon entry to eacn of these subroutines is 
detailed in [Ref 19: pp. 8508-65]. A cnanee in the hardware 


ironment is accounted for ty cnanging tne code within 
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0400:0090 


Console 
Command 
Processor 


and 


Basic 
Disk 
Operating 
System 


:2500H 
BIOS Jump Vector 
:253FH 


BIOS Entry Points 
(21 Subroutines) 


Disk 
Parameter 
Tables 


Uninitialized 
Scratch RAM 


Figure 3.2 Operating System Memory Map 
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the 21 subroutines and meeting the entry and exit corcitions 
meee specitied in this reference. Recall tat a skeletal 
BIOS.APGO file is providea as a model for this purpose. 

Tne Disk Parameter Tables shown in tne previous 
figure are used by tre BIOS to obtain the characterisctics 
Oe each device. Tnese tables exist in a rile separate from 
tne SIOS and are included durin assembly tnrover tre use of 
the INCLUDE <filename>d.<tiletype> instruction at the base 
Berne BIDS. The source code for the tables as well as the 
Uninitialized Scratcn Ram Area, cante automatically 
generated by the GENDEF.CMD utility. This a 
<tilename>.DEF tile as input and produces a <filenane>.LIB 
ENG as output. Tne contents of <rilename>.DEF are simple, 
one line disk definition statements. Tmestermatr. for 158 
Statements and tneir meaning is described in detail in [Rer 
12: pp.72-e80). 

oneee OS T ae so modified and tne Di <x 
m reter Table file created, tney are assembled using 
ASM86.CMD. Tne resulting nex file is concatenated with 
Or. He6 using PI®.CMD ana a command file for this single nex 
file iS generated usine GSNCMD.CMD. Finally. the new 
Ma tideg system tnat results is placed op tne disk as 
Mess usine PIP.CMD. The process describes above is 
Benlcted in Figure 3.5. Note tnat tne 8080 model option of 


CP/M-E6 is shown in tnis example. 
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1. USER.DEF ==> GENDEF.CMD ==> USER.LIB 
2. USERBIOS.AS6 ==> ASME&6.CMD ==> USERBIOS.HEE 
S. OPNS * USBRIBIOS.HBO ==> PIP SOMD 


==> CPMSYS.H&6 


4, CPMSYS.H36 ==> GENCMD.CMD ==> CPMSYS.CMD 
(E9890 codela4t]) 


O EMS NS CMD ==> PLP CMD ==> CPM.SYS 
(RENAME ON NEW DISK) 


Fizurea 4.5 Steps tor Creating a New CPM.SYS 


Two software components remain to be adapted: the 
üo4der proeram and the boot HOM proeram. Tne loader program 
Moma Simplified version of CP/M-86 and contains cnly encuen 
mere. processing capability to read tne CPM.STS file from 
disk to memory. Three tiles are provided for the 
development of a loader: LDCPM. #486,  LDRDOS.KS6 and a 
skeletal LDBIOS.A865 source file. aren LOBIOS.A86. file 
reflects the hardware to be used in tne loading operation 
EM 0. not necessarily refiect tne total nardware. Inis 
file contains the same 21 entry points as the BIOS.AES File 
ES tne same entry and exit conditions and requires the 
Bae type of Disk Parameter Tebles and scratcn pad area. 
Tne generation of the LOADER.CMD rile is depicted in Fieure 
3.4. Tne resulting loader must be small enough to fit 


entirely on tne reserved system tracks. 
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1. URLDBTOS.A86 ==> ASMBG.CMD ==> URIDBIOS .FE6 

DE DUDMeUBoNCEI DEPOSOHECCCEOUPLDEIOS.HEG-ZOPIP.CME 
==) LOADER.HES 

3. LOADSR.HE6 ==> GENCMD.CMD ==> LOADER.CMD 


4. LOADER.CMD ==> LDCOPY.CMD ==> LOADER.CMD 
(LOAD ON SYSTEM TRACKS) 


Figure 3.4 Steps ror Creating LOADER.C™MD 


Tne development of a boot ROM program depends only 
EN e physical device used to load tne cperating system. 
Its single purpose is to load tne program located on tne 
system tracks into RAM and pass control to it. NO 
Ms provided that details tne boot ROM for an INTEL 153230 
204 Floppy Disk Controller and serves aS an excellent 
Example. Roweyer, 5ecquse tne metnod used. wrIil vary "widely 
from device to device, no files are provided tnat simpliry 


tais development. 


B. AEGIS IMPLEMENTATION OF CP/M-26 
1. Boot ROM ana Loader 
In tne AEGIS implementation otf CP/*"-86 used during 
the initial development work of tnis thesis, two boot ROM 
programs and pnerrssassocıareo loader prozrams «ere 


available. Eoth are located at tne base ot the INTEL 957 


nitor in the SK byte EFROM of tne iSBC &6/12A. Tne first 





os tae System to be booted from either tne single or 
Boole density INTEL MDS floppy disk drive by executirg tne 
command  "GFFD4:Q" from tne monitor. The seconc will boot 
the system from tne bubble memory by executing “GFFD4:4" 
from the monitor. 
2. A Modification to tne BIOS 

recall from Section A-4 above that any hardware 
change within te system reuuires some of tne 21 BIOS 
subroutines to be rewritten. Pecwanee occurS HOt. Only By 
the addition of  nardware but also wnen a comporent is 
memovedc either because it nas tailed and tnere is no 
placement or it is no longer needed. In rer nareware 
environment as flexible as tnat required by the AEGIS 
Enect, tne standard reconfiguration process becomes an 
extremely timerconsuming task. 

Booey ra tem Enis provwem, a metnodmwas developed as 
a part of Almquist and Stevens” work in wnicn only minor 
cnanges to the BIOS were required to alter tne hardware 
Bere euration. with this technique, all ot tne FIOS device- 
Sependent subroutines are extracted into e separate file for 
each unique device. TAGS Sveci tc devVece=tenencent rourines 
Seer INIT, SELDSK, HOME, SETTRK, SETSEC, READ anc WRITE. 
mae physical location of the entry points to tne routines is 
tarined from an ordered label table file and the BIOS 


accesses tne routines tnrougn an indexed CALL instruction. 





Powerosetecurmiagne works Is shown in Figure 2.5. In 
this example, a call is made to tne BIOS to READ DEVICE #2. 
The BIOS makes a jump to tne READ entry point. However, 
instead of doing an actual READ at this point, tne 
device number is determined and a call to the address found 
Eng r:ne second position of RDTBRL is made. Tne code tnat 
Berforns the READ function for DEVICE #2 is then executed. 
Tne code for the seven device-dependent functions 
mee written and debugged independently ot any otner code. 
To add the device to the system requires one INCLUDE 
<filename>.<filetype> statement be added to the EIOS file, 
mae corresponding seven entry points be addec to tne label 
table file and the Disk Parameter Table be updated. The 
mages for creating tne CPM.SYS file remain unchanged front 
those presented in Section A-4. To remove a device, the 
process is reversed. Clearly tnis metnod allows the 
hardware dependent code (and nence, the narewere itself) to 
be more easily intezratec in or removed from tne operating 


System than the standaéra BIOS structure did. 


eee CULTIUSER SYSTEM 

EMS NOt a múltiuser or multitasxine operating 
system. Another dador development of tae Alirquist and 
Stevens” researcn work was a metnod by wnicn eaca single 
board computer in the System could operate independently of 


the oOtners under CP/M and still nave access to tn2 saarec 
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a call is made to the BIOS to READ device #2 


BIOS jump vector 


determine device # 
call to INTBL offset device # 
ret 
determine device # 
call RDTBL [offset device j| 
ret 

(remaining 19 subroutines) 


INCLUDE LABEL TABLE 
INCLUDE DEVICE #1 
INCLUDE DEVICE #2 
* (an include statement for remaining 
devices) 


INCLUDE USER.LIB (the disk parameter tables & 
initialized scratch RAM) 


dw INIT] (replaced with physical address 
of INIT] at assembly time) 
dw INIT2 
- (a "dw" statement for remaining 
* devices) 
dw READI 
dw READ2 


| code for seven device specific 
functions of device #1 


INIT2: code to initialize device 
ret 
READ2: code to read device #2 
: ret 


remaining device dependent files 


Disk Parameter Tables 
USER, LIB . 
file 

Unitialized Scrateh RAM 


Figure 3.5 Path of a BIOS Function Call 
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resources (tne disk drives and tne bubble memory) of tne 
system. The multiuser system that resulted can 5e broken 
down into türee functional categories:  syncnronization of 
common memory usage, boot loading all SBC“s and write 


protection of a user’s allocated disk space. 
1. Syrenronization 

Boe Stated sin Chapter Il, the RAM or Gach iSEC 85/124 
is not accessible via the MULTIBUS and tnerefore, all aisx 
and bubble memory read/write operations must be performed 
througn a buffer in tae common memory. This requires a 
Ewnchnronization scneme tnat will ensure a single computer 
can successfully complete a read/write operation before 
another computer is permitted access. 

A  ticket/server technique nad been developed ror 
mors purpose. Toere oni reda CALL RECGUEST izstrucčtionr to 
cec prior to all common memory read/write operations 
and IAE DAS E instruction be placed after tane 
reaa/write operation. Tne CALL REQUEST accesses the 
"ticket" variable in common memory for a ticxet number and 
waits until that number is equal to the "server variable, a 
number also found in common memory. The read/write 
Operation is then performed and tre CALL RELEASE advances 
Paemeserver number, thus releasing common memory to tne next 
packet nolder. 

The code for tnese subroutines is contained in the 


mee SYNC .AS6. Dtelceinc'udsd 1» the HIOS tnroven an 
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INCLUDE statement placed immediately following tne last 
INCLUDE statement for tne device files. 
2. Boot Loading All iS8C"s 

Because the common memory variables must be 
initialized only once, two versions of tne CP/M-H6 operating 
System had been developed. The file CPMHMAST.CMD is the 
master version that Dertorns tne common menory 
initialization while CPMSLAVE.CMD is the slave version that 
goes not. 

The master board is boot lcaded with CPMMAST.CMD 
from the bubble memory. Once this board is operational, the 
command "“LDBOOT” is executed and results in a copy of 
BOOT.CMD beine placed in the common memory. Next, the 
command  "LDCPM" is executed. Tais places a copy of 
MeroLAVE.CMD into common memory. Prom the monitor of ‘tne 
remaining SBC’s, tne command GEO@@:@44¢4 is executed. This 
causes tne CPU to execute tne code of BOOT.CYD wnicn, in 
Ben, moves a copy of CFMSLAYE.CMD into local RAM and 
Nosnsters control to it. 

9. Disk Write Protection 

Disk write protection was achieved tarougn a log-in 
Mieres. A loz table is initialized in common memory as e 
barge of tne master version initialization. Tne number of 
EmUnlIes in tne table correspond to tne number of disk drives 


Eloeical devices in tne system. AS part of booting tne 


¡e 
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Operitine system, the user iS queried tor the console number 
being used (located on tne front panel of eacn console) and 
Me disk drivs to loz on to. The loe table is checked after 
this entry to determine if tne desired drive is free. If it 
is, tne user console number is placed at tnat drives 
position in the loge table. If it is not, the user is asked 
Nure-seiect a drive. 

Tne user console number is also stored in the local 
variabie USER. Neiteseproteetion 25° accomplisnea by 
comparing the value in USSR to the currently selected 
Mmoetcal disk number and aborting any write overation if tney 
Menot tie same. 

It was considered desirable to be atle to cnange 
disk drives without tre need to reboot tne board. A log out 
Meeecaure was written for this purpose. mer tae command 
"LOGOUT" is executed, the USER variable is reset, tne log 
mie 1S upddted and tne user is again requestec to enter a 
Beem drive to loz on to. 

Pie mrfund, common menory utilization employed as a 
Ee cit of the multiuser system dev2loped by Almquist and 


evers is depicted in Figure 3.6. 


Dee MCORTEX 
MCORTEX is tne operating system tnat was developed for 
mre sPY~1A radar emulation. In the tinal version presented 


by Klinefelter (Ref. 2], “CORTEX was set up to aancle ter 


if 
cn 





E000 : 0000H 
ticket | server | logtbl 


CP/M Buffer 


BOOT .CMD 


CPUSLAVE. CMD 





Pigure 3,6 Common Memory Allocation Map 
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virtual processors for eacn real processor. The data  Dase 
Mon walen ell scheduling decisions are based is tne Virtual 
Processor Map (VPM) located in common memory. The VPM 
EmU2insS the control and status information on each virtual 
processor required by MCORTEX to coordinate the concurrent 
processing. 

All processes managed by MCORTEX can oe in one or three 
NES Tunning on e Teal processor, waiting for some event 


momoccur or ready to run (waiting to gain access to the real 


(b 


processor). It a process is in LNe waliting state, it coulc 
i ting ror an event to occur on a real processor other 
than the one to which it was assigned. An eventcount table 
Nexmaintained in common memory for notification purposes. 
Meemever a real processor completes an event, tne table is 
updated and a message iS broadcast to all otner real 
processors in tne system trat scme event has just been 
completed. aci ea Processor pen checke tne eventedunt 
table to determine if the event pertains to any cr its 
TOER processors and reacts accordingly. 

The technique used tor broadcasting an 2vent employed a 
[meee of global interrupt issued on tae MUITIFOS. Recause 
the development of the Micropolis interface altered the 
tecnnique somewnat, the details of it will be presented in 


the next chapter. 





IV. MICROPOLIS HARDWARE INTERFACE DEVELOPMENT 


A. OVERVIEW 

NoueswMNcropolUsediskosystem offers am interface structure 
that is suitable for use with either programred 1/0 or DMA 
data transfers. In an effort to maxe maximum use of 
available system nardware, tne programmed I/O mode was used 
in this implementation. This enabled an interface to be 
Heicned witn tne INTEL 8255 programmable parallel I/O cnp 
locateà on the iSEC 86/124. 

Pocalls?rom Chapter II tnat all RAM on each SEC is not 
mereessidle throuen the MULTIBUS. Therefore, all control, 
status, and data information intended for the Micropolis 
disk system nad to te passed tnrougn the common memory. 
Because the disk System was intertaced into a single SBC’s 
2295 DORT, tne disk controller nad no metnod or 
monmmunicating directiv with tne common memory. Tc overcome 
EU. problem, a timer-controlled interrupt wes designed. 
mes allowed tne 8086 CPU to be interrupted at periodic 
Exnyvals and effect any necessary communications between 
SOTO memory end the controller. Tne distinct advantage or 
meses Lecnnique is thet tne singla board computer used for 
the interfacine can still be used as an independently 
operating computer with STI “disk operations beirg 


MaS parent to the user. 





In tne following paragrapns, tne details of tne 
mitermmace design and the timer-controiled interrupt desien 
are presented. TAIS discussioni is limited to the 
mevelopment of the designs and only those low-level routines 
needed to test their validity. Tnessorrware implementation 


moto tne AEGIS system will be discussed ir Chapter V. 


fee TICROPOLIS DISK SYSTEM 
Chapter II stated the general characteristics of the 
Micropolis disk system. Tnís section expanas On tnat bY 
presenting the technical interface requirements as well as 
NUS 72eneral operation of the disk contreller. For more 
Mmeorration on the Micropolis disx unit see [Pef. 13]. 
1. Interface Signals 
Nena o ae  “Lcropolls disx« drive is nade 
bDurougen a 54 pin edge connector located on tne controller 
RIRE E circuit board. ime Yatervace 15 Structured around 
EN br. bi-directional data bus and 9 control lines. ET 
EN o! retfsrsncs, the © data lines will hereerter te 
mersrred to as PUSO-BUS? witn the BUSY line corresponiing to 
goeie ast significant bit and tne EUS? Aline tne most 
Seeeniticant oit. The control line nares ant a complete 
deseri ption of @ccn is contained in the list below. Note 
Ern this list, reference iS made to tne logical 
@emaition of the signal (true = 1 and false = 0) ratner tnan 


tne signal’s electrical polarity. 





ASS ce tas Mmicropolis controller can slave 
Erik una 000% 11, tnis signal is provized to 
select which disk unit to use. anlssappnlieerron only 
EE 112065 one disk unit and it 1s jumper configured to 
respond to address Ø. Tnus, SEL snould always be Y. 

b. ENABLE: This Signal is normally held true. Ir 
made false (2 microseconds minimum), a reset is applied to 
the controller logic. TACO ol Cena Ll gyadiceate that it 
is busy (tnrougnh tne CBUSY signal described below), 
Matan: “tildes and resisters are tnen initialized ana 
approximately one second later, tne controller will indicats 
Wat. it is ready to accept commands frcm the host corputer. 

C. STR: Boesentitesstrose is 4 Signa] trom tac 
Bocue cCOrputer to tne controller that the information on 
BUSU-BUS7 is valid. Tne nost pulses the writes srrots ‚line 
while driving tne bus. Om thempremting edee or WSTR, tse 
momtrolier will copy tre contents or the bus into a buffer. 
The byte is tnen interpreted by tne controller as either 
@entrol (DATA =) or data (DATA = 1). 

de RASTAS The read strove is a signal used by the 
ELI cond ave to the controller tnat it is ready to input 
oy te of information. Waen tae nost drives RST? true, the 
Mano ler. drives tne ous with tne contents of eitner 118 
eae butter (DATA - 1) or its status reeister (DATA = 2). 


Tne controller will 4rive tne bus as long as RSTR is true. 


ou 





Mus”, once the Post has copied the bus, RSTR must be rade 
false again to regain access to the bus. 

e. DATA: Pnis signal selects eitner tne controller 
data or control ports as described above. 

ooo mene controller will “sets CBUSY to 2 
whenever the nost issues it a command. CBUSY is returnei to 
1 by the controller wnen tae commana is terminated. 

8. ATTN: The attention signal is set true cy tne 
controller at tne end of eacn command. The nost responds by 
reading tne Termination Status byte trom tne data port. 
ATTN is set false by the controller only after the 
Termination Status byte nas been read. 

nh. DREQ: Data request iS used to request the 
Pransfer of data to/from tne controller. tnesalreetion ot 
me transřer is controlled by tne$ OUT signal. Data can only 
pu ransferred by tne host in response to DREQ. 

ice OUT: Toisa iadi cates tha direction of -data 
meansfer. ANA LOE Trans er is from controller to 
host (a READ operation). OU wt is fron-host to 
controller (a WRITE operation). 

A ous linessand control Sienals (except CBUSY) are 
mers VE low at the interface connector. The physical 
EN3ce tO the € controller bus lines must oe tarouen an 
INTEL €226 invertine bi-directional ariver/receiver or its 


équivalent proviaed by tne host system. Tne nost must also 


Euovide 1K onm pullup resistors on each of the bus lines. 
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Interface to tne SEL, ENABLE, DATA, WSTR, and RSTR 
control lines is tnrouegn a 74358 inverting driver or its 
equivalent. Tos ATIN CEUST, DREO. and OUT control siznais 
are used in a DMA interface environment. If operation is in 
the programmea I/C mode, tne DMA signals do not nave to be 
pavesically connected. The logical condition of these 
signals can be obtained by reading tne status resister (see 
RSTR above). 

2. General Operation 

Command ere@cutioneis started in the controller board 
Beewriting a command byte to tae commana port, followsa by 
Writing Six parameter bytes and a GO byte to the data port. 
The command byte identifies the type of commard while tne 
parameter bytes contain tae “control and adaressiae 
o: mation necessary to execute it. Tnezclzprre actually 
mers the command execution and can contain any value. 
meer the controller nas executed tne commanc, a Termination 
Sus byte is written to its data port and ATTN is set. 
When the nost reads tnis byte, the command execution is 
Pemmmorete and the controller can accept a new command. 

5. Commands and Error Recovery 

Three types of commands can be executed: non-data 
ne ter, transfers from host to controller (write), and 
transfers from controller to host (read). The non-data 


transfer commands are used for disk maintenance. This set 


Eucommanis permit, among otner things, the initialization 
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and/or verification ot all 58@ tracks associated with cne of 
the five drive neads. 

The read and write commands have tarse major 
Bons, “Operation on an entire track or a single sector, 
programmed I/O mode or DMA mode, and automatic retries 
enabled or disabled. The single sector, programmed [/0, and 
automatic retries enabled options were used ror a) 
read/write operations in tnis implementation of "icropolis. 
Eee autonatic retries feature is an extremely powerful one 
and warrants furtner discussion. 

Ir automatic retries are enabled, tnree levels of 
Mi are performed by tne disk cortroller for data errors. 
level on€, a correction attempt is made on the data using 
mec standard  CRC-CCITT 16th order polynomial. If tne 
Enecetion attempt was Successful, the corrected data is 
feaasmitted to the host. If net successful, a level two 
metry iis invoked. EVE NON repeat The operation dnd 
E ction attemnpt up to ten times. IF still unsucesstful, a 
level tarse retry begins. In level tnree, tne read 
amplifier ain is increased and level one and two retries 
mu wperformed. If tnis fails, tne nead positioner is offset 
one way then the other from the track center and level one 
and two Tetries are performed again. If all retries fail, 
E ommand ts dborted and an error condition is placed in 
tne Termination Status byte. This feature clearly provides 


Mera niezen degree of data integrity and error recovery. 
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€. Parameters 

Pest ee parameter bytes required as a Dart of 
command execution must be transmitted to tne controller even 
mouen some may not be used. eS CrTi ption Of “those 
parameters is containei in tne list below. 

a. Parm 1: Bits 4-7 contain tne nead address (a 
value between ¢ and 4). Bits 2 and Y are set to Z an4 bits 
a 2 contain the unit address. Hecalierherseor!iy one 
Mereropolis disk unit is used and that its address is CU. 
This makes only five values valia for Parm 1 depending on 


the head selected: @@F, 1H, 2£H, S£H, and «£F. 


13 
(D 


b. Parm z: Bas  odraneter contains t least 
menfi cant S bits or the track address. 

Gee amc sc tts: OE Ontan the most, sieniti-cant < 
Pets Of the track address and all others are set to C. 

1. Parm 4:. Contains the sector aadress (a value 
between 2 and 2%). 

Fear: Comitan sm ns Number or 7 sectors to 
process. In this implementation, this value is set to l. 

tee Rar S: nonsEpspdmevev is used orly in track 


oriented commands and since sector read/write operations 


mememused, this tyte is always sev to Y. 


Cee rk SVIOUS WORK 
IuuccMIcropolis unit nad been previously interfaced in an 


INTEL MDS single user environment by James Conn (Ref. 14]. 





This interface was constructed using the iSAC’s onpoara 2255 
progranmable I/O device. 

Ino 55 T be conflewred in a cortination of tnree 
modes: mode @, mode 1, and mode 2. These modes and the 
operation of tne device is discussed in detail in [Eef. 15) 
In John’s application, the 8255 was programmed in mode 2 and 
BU. Mode 2 provided 8 bi-directional data lines at Port 
ANS control lines for the bi-directional data port and 3 
output only lines at Port C. Mode 90 provided B output only 
Pines at Port E. 

Tne required 2226 drivers with IK onm pullup resistors 
are hard-wired on the 86/12A in line with tne bi-airectional 
Manta port of the 2255 and did not have to be added. The 
Eon Ted 7453 drivers were inserted in sockets A11 anc A12 
DN Ue iSBC in line witi Ports B and cC. Joan s final 
interface design is depicted in Figure 4.1. (All active 


low signals are indicated by following tre signal name with 


/ », suen as ACK/. Tnis notation will be used tarouenout 
Hae renainder of tris tnesis.) Note trom this figure trat 
tne STB/ and ACK/ signals needed by tne 8255 to laten input 
data and enable the tri-state output buffer are provided by 
Bene two of tne Port B output lines into the STB/ and ACX/ 
BEputs. These signals must be controlled locally as the 
disk controller provides no compatible signals. 

AS part of James Jonn’s work, ne also reconfigured tne 


CP/M BIOS to accomodate the Micropolis disk and two INTEL 
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Figure 4.1 Previous Design 
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EDS floppy disk units. This gave a complete, sirgle user 


system with a total of seven accessible drives. 


D INITIAL EFFORTS 

It was envisioned to expand on Jonn’s work to accomplisn 
Esrartion of tne Micropolis disk drive into tne AEGIS 
multiuser development system. Tnerefore, the first Logical 
Step was to set up James Jonn’s system and test it. 

Various files were read trom tne floppy drives and 
Barren to tne Micropotis drives ana vice verse. Tnis 
Orginally appeared successful. Fowever, whenever a source 
code assembly language file was read and aen assembly 
EE -Upredc on that file, tne assembly continuously failed. A 
pmIEI-OULt of the source code rile was ootained and various 
ees were found that did not exist in the original file. 
mene ed to the Bellet that a Bad copy of the  15M86.CMD 
Seeemoler was being used and it was crasrine nov oaly 
tne system but also tre file it was operating or. A good 
Geoy of t^e assembler was obtained and the test repeated 
with continued negative results. Hardware connections were 
Memrri@d and re-verified. Software was also cnecked and re- 
EDUGCkKked. Nevertheless, numerous other >xperirents still 
produced negative results. 

At this point, the design was re-examined and this 
macovered tne problem. A timing analysis was performed and 


ara, rom 


p 


is presented in Figure 4.2. The latch of WRITE 
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Figure 4,2 Timing Analysis of Previous Design 
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Merosi to the controller occurs within a valid region 
(window) as shown. However, the latcn of READ data from 
Mie” controller to the host does not. TOIS OCCUrTS OpecSuSe 
the RSTR/ ana STB/ signals are pnysicelly wired togetner. 
meteewill go active/inactive at exactly the same time. Tne 
controller wiil nolda the bus active only for 1¢@ nanoseconds 
maxinun after RSTR/ goes inactive. However, the 3255 
requires 158 nanoseconds minimum to latch the data after 
STB/ goes inactive. TOUS eNe data knot is latcned nay or 
may not be valid. This explains why marginal success was 
Oerarnead when source files were just written to anc read 
Gnom the Microrolis. [It also explains way random errors 
that were not present in the originali source file were found 


Brathe file that was printed fron tne Micropolis. 


E. NEW DEVELOPMENT 
IES 12 

A new interface was cesigned in wnich tne ACK/, 
STB/, RSTR/, and WSTR/ signals were all inaependently 
@emtrollec by setting tne appropriate bit on the 8255. 
Because tne condition of each individual signal is now under 
meoruware€ control, it can be ensured that the data will 
remain Valid long Enough for either tne controller or tne 
Meo) tO latch it. The new design is presented in Figure 4.3 
and tne associated timing diagram in Figure 4,4, AS SNOWN 


Mere 4.4, all latchning occurs in valid windows. 





NOT USED 
NOT USED 
NOT USED 
NOT USED 


Figure 4.3 Interface Design 
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Figure 4,4 Timing Analysis of Interface Design 
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CO Die a CyGe Of information to tne controller, 
pne byte is first written to Port A of tne 8255 ana tne ACK/ 
Signal is set to 2, enabling the tri-state output buffer and 
Bnivinge the bus lines with the contents of tnat ouffer. 
Next, WSTR/ is turned on (set to 1) and turned oft (set to 
p. Tne controller will copy tne bus lines into an input 
buffer on tne trailing edge of WSTR/. Finally, tne tri- 
state buffer of the 8255 is disabled by setting ACK/ to 1 
End the write operation is complete. 

To read a byte of information from the controller, 
EOR is activated. This will cause the controller to drive 
tne bus Lines with its data tuffer as long as RSTR/ remairs 
active. Nex Qo by siseetunned on (set to @) anc turned off 
feet to 1). Misco pes the bus lines into the *e255 input 
puffer. Lastly, tne RSTR/ signal is deactivatec and tne 
Myce Can be accessed by reading Port A of tne E255. 

Each of the bit set/reset operations needed in the 
MO” write functions just described, requires a MOV ard 
ENEUUT instruction for a total of 20 ciock periods in tne 
8186. Mita a  S@4nz clock, this is 4.09 microsecends and 
clearly, more tnan meets tne response or settling time 
wC Tra ints of either the $255 or the disk controller. 

2. Implementation end Testing 

eden cn. Figure 4.5 was set up on an 1530 

86/124. The followine hardware chanees were required to the 


board: 
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Remove jumpers: 


E13-E14 517-518 PAISES 
ELOSELG E19-E22 228-529 


Aid jumpers: 
129-515 
K30-E17 
ESO-E25 
Add 7438 drivers in socxets: 


Anl 
XAl2 


Next, a) CalleewaSeconustructed toat would interface 
me ¿1 34 pin edze connector of the 86/12A to tre J121 34 
meme edge connector of the Micropolis controller. The 
Me. requirements are saown in Table 4.1. Tnose pins not 
Srown are not required and are not connected. 

The 86/12A was tnen placed in tne iCS 240 cnassis vor 
esting. Only the most primitive routines were written to 
ind Write to various heads, tracks, and sectors of tne 
Micropolis. Tnese were executed under DDT&6 to allow manual 
mecaneing of tne command and parameter bytes, Miner. a 
male character was written to till an entire sector and 
Enen read back. Tais was Successful. Next, 2 text nessage 
was prepared and written to a variety ot different sectors 
Ed tracks of each drive nead. In eaca cese, the message 
BED retrieved successfully ind it was concluced  tnat tne 


design was functional. 





iSBC 86/12A Jl MICROPOLIS J101 
CONNECTOR PINS DESCRIPTION CONNECTOR PINS 


Table 4.1 Interface Cable Connection Requirements 
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ieee CINTERRUPT MECHANISM 
1. Design 

Mauer rpesinteriace cesignecomplere, it remainec to 
design the timer-controlled interrupt for polling common 
memory. Tne design was based on two devices available on 
mae 565/124: the INTEL 8253 programmable interval timer anc 
the INTEL £253 peripheral interrupt controller. 

The $253 has three ircependent 16-bit counters and 
eaeiecan Oe programmed in one of five modes. Tetrails ot its 
operation can be found in [Ref. 15]. Tne design employed 
eee uses only covnter 4 and tt is programmed in mode 40, tne 
"interrupt on terminal count mode. In this mode, the 
output of the timer will be driven low when tne mode control 
Ss Written to Jt. After the count value is loaaed into 
Count port, the counter will begin counting down. Upon 
EN 5rssS the terminal.count, tne timer output will go nien 
Sea renain nigh until a new count value is loaded. 

The mode control word selected was SCF. This zives 
wer 4 tne following characteristics: operation in node 2, 
mary 16-bit counter, and load count value as least 
Seni ficant byte first then most significant byte. The 
MONET valve used was SY9CE wnicn corresponds to an interval 
mals millisecords at a cloc« frequency of 1.23 MHZ (thea 
clock frequency supplied to tne 8253 by factory default). 

Like the 8253, the INTEL £259 has many Aifferent 


options available. Only those appropriate to tris design 
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re covered in tne following paragrapns. For more 


tv 


information see [Ref. 15]. 

Three initialization command words (ICW) and one 
operational control word (OCW) are required to properly 
configure the 8259. ICW1 is set to 15H. This corresponds 
momedee triggering, no slave interrupt controllers, anc ICW3 
is not required. 

ICW2 is set to 44E. Tais ics used in Conjunction 
with the interrupt level number to arrive at the address in 
tne interrupt vector table (see Figure 2.2) from wnich to 
obtain the code Seement and offset values for the interrupt 
handler routine. Interrupt level 6 was cnosen anc tnis 
corresponds to a vector table address of: 

4 * (40H + SH) = 118H 
IMMerefore, tne address of tne interrupt nanıler must te 
Boaded in tnis location. 

IDA iso sert to OFE, o eand cartes 220265 mode, 
EE udric end of interrupt, and bufterea mode. 

OCW1 is used to mask unused interrupts. It iss set 
mo BPH. Tnis enables interrupt level 6 ana disadles all 
Others. 

ER Implementation ana Testing 

To implement the desien simply required removing 
default jumper E79-E835 and connecting a jumper between E75 
Sem oes. This connects tne output of timer @ on tne 8252 to 


Peer interrupt 6 input on tne 8259. 
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Tote as written thet “Initidlized 
botn devices as descibed above and loaded an interrupt 
Bsndier address into the vector table. Tne interrupt 
handler was a simple routine that performed tne followine: 
Saved all registers on the stack, printed a message at tae 
console, restored all registers, and reloaded tne count 
Lue into tne timer. MINGSEUBSDGS toe timer=-cortroliled 


meyerrupt functioned normally. 


G. MCOPRTEX INTERRUPT 

AS stated in Chapter III, the MCORTEX operating system 
merece a type of giobal interrupt for message broadcasting. 
The hardware configuration required to achieve this is 
depicted in Figure 4.5. Port G Or tae 2255. 15) imitialized 
as an output port and to issue tne interrupt requires 
Bine bit 7 of port C to 1. 

lis envisioned that future development will allow tne 
CP/M-26 operating system and “CORTEX to co-exist in the 
mocal RAM of each independent user on tne AEGIS multiuser 
development system. THis’ Was taken into account in this 
Besearch effort. Nevertheless, changes in the hardware and 
hardware initialization will be necessary before vnis can be 
achieved. Those changes are identified below. 

Botn MCORTEX and CP/M-B6 (with the Micropolis 
me eration), initialize tne 8259 interrupt controller witn 


exactly the same initialization command words. Inrerrust 





INTRA 
to MULTIBUS 


Figure 4,5 MCORTEX Hardware Interrupt Connections 
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Io asc noOsSen tor Micropolls to be of a lower priority 
than the interrupt level 4 used by MCORTEX. However, recall 
om Section F-1 tnat tne operational command word is set to 
BFF and tnis masks all interrupts except level 6. TOS 
value will nave to be changed to AFH to activate interrupt 
level ¢. 

Mer CORTEX Anterrupt bit will elso nave to be moved as 
shown by tne dashed line in Figure 4.5. This is required 
Brause the Micropolis disk drive uses Port C as a strobed 
input/output port. Tne nardware dependent source code sound 
Mame advance, pre-empt, and initialization processes of 


MCORTEX will have to be updated to reflect tnis change. 
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V. SOFTWARE IMPLEMENTATION 


A. MAINTENANCE SOFTWARE 

BETOSe meEnewrrcropolis Gisk unit could be used. it was 
first necessary to write a routine tnat would initialize and 
Amas tne disk surfaces. TNESPUTDOSe G2 initladlz2ation is 
MON Write the address and data fields or Gach sector onto the 
surface. Hess 1s Controller Invoked" function. afer 
initialization, the address field will contain tne requirec 
meaaqa number, track number, and sector number. RA, Feet a 
melas will contain 51H. 

MIEDO se tor Tormattiug cis to change tne Contents of 
mye cata fields from the SLE that resulted durine controller 
we alization to ESH. Tnissil necessary Cecause  OP/*—86 
expects to find E5£ in tne data fields in order to rreate a 
directory space. 

The routine that was a¢eveloped, MICVAINT CMD, is 
completely menu driven and extensive error cnecking is 
Erormed on all user supplied input. This routine provides 
Or iy initialization and formatting options but also 
merification of A aia 101 ani verification of 
mormattine. Tnese additional facilities ernaple tne user to 
EDS y uncover any dlsk Surface detects. For an explanation 
of how to use MICMAINT.CMD, see APPENDIX A (User’s Manual 


for the A¥®GIS System). 
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Tne Micropolis disk surfaces were Suceecs fully, 
Moartiatized and formatted with MICMAINT.CMD. No surface 


defects were found in tne initialization process. 


B. DEVELOPMENT OF THE DEVICE DEPENDENT ROUTINES 

As stated in Chapter IIl, seven device dependent 
routines were necessary in order to intertace tne "icropoiis 
disk drive into tne AEGIS development system. Tre: SHLDSK, 
HOME, SETTRE, SETSEC, BEAD, cand WEITE routines were 
developed simultaneously. Tale was a consequence of tne 
Acropolis 512 byte phySical Sector leretn. Tre CP/4—e6 
Operating system utilizes a 128 byte logical sector leneta. 
mmerefore, a physical to loe Tc al Sector napping 
(blocking/deblocking tecnniyue) was requires ir order to 
Mmmm cate with CP/M. Tne method used nad an ettect on all 
BRT these routines. 

mre L poutine required special attention as it was 
fee net only to initialize the parallel I/O port, the 
EET. and tne interrupt controller but also to embed the 
Pees interrupt handler within the operatine syster. TBG 
details of beth the INIT routine development and the 
blockinz/3eblocking alZoritnmTs used are given below. 

1. Initialization and Interrunt Zardier 

Ine hardware Initialization reauired tor the INIT 


Toutire had been previously developed anc tested (ses 


Enapter IV). Peremained to develop enm interrupt nandier. 
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kecali wtnat ss tue SOLE purpose of tne interrupt 
Engler 15 to effect communications between tne Micropolis 
ISE controller and the common memory. A status byte, 
command packet, amics bDwtewEcector buffer were 
established in the common memory to coordinate this effort. 
Mircea. denrcts the resulting map of common menorr 
addresses. 

The status byte serves two purposes: to inform tne 
Meerrupt hHanaler that @ disk read/write operation is peing 
requested and to return the success/railure code tnat 
Besulted during that operation. Pe ls imitiag]y2ed to. 2EME 
a part of tne "icropoiis IMIT routine. Tre startus Dyte 
is set to 20H to request a disk operation and tne interrupt 
Euer will return AH if tne operation was successful. If 
a t'ailed, one of the nine error codes listed in the 
Acropolis Technical Manual pages 24-25 is returned. 

Mco NAS pacer consists of Client values: tne 
command byte, six parameter bytes, and tne GO byte. The 
Meemameter bytes were discussed in detail in Chapter IV, 
Section B-4, Tne GO byte can take on any value ana @ was 
used, Meco mmaad” byte used 12 this implementation can be 
either 47F tor the write operation or 4EH for tne read 
@peration. Mes a ues L HG read and write 
Operations the desired characteristics of single sector 
processing, programmed 1/9 data transfers, and automatic 


retries enabled. 
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E000: 00008 
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Figure 5.1 Final Common Memory Allocation Map 
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Tne sector buffer is used to transfer data to end 
mum the controller. Botn primary and alternate data 
transfer protocols are possible in tne programmed 1/0 node 
ard thes® are shown in Figures 5.2 and 5.3 respectively. 
mae alternate protocol differs from tne primary protocol in 
mies anNOUnt@ or Status checking required. AS snown, tne 
mary protocol requires a status cneck between tne 
Master of eacn data byte wnile tne alternate does not. 
tee of tne alternate protocol is possible cnly it the loop 
Ime is ereater than the 1.5 microseconds/byte response time 
Mie the controller. Recall fror Chapter IV that all 
operations require a minimum of a MOV ana an OUT instruction 
IA ese ¿wo Instructions need 4.2 microseconcs to execute. 
Thus, the alternate data protocol was employed in tne 
Enterrupt nandlér to improve response times. 

à boriefťf description of how the resuiting interrupt 
Bıneler works is in order. wnen tie tiresr-controlled 
Enot occurs, the interrupt nândler routine wiil save 
wose registers trat are ns22ed by tne routine on tne stecx 
aoe Cneck tne common memory status byte. Iż 3 non-zero 
yalue iS found, tne timer count value is re-loaded, tne 
Ae Steers are restored from the Stack, and a return is 
eeecuted with no furtner action taken. It a zero value is 
found, tne command byte is read to determine the direction 
of data transfer (to tne common memory sector buffer for a 


Lu Operation and trom it tor a write operation). Nert: 
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WRITE DATA 


GET DATA 


MOVE DATA 
TO BUFFER 
DATA PORT, 


Figure 5.2 Primary Data Transfer Protocol 
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READ 


STATUS READ 
STATUS 


GET DATA 
FROM BUFFER 


DATA PORT 


Figure 5,3 Alternate Data Transfer Protocol 
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NINE command PACKER iS Transmitted to the controller 
moo when the DREQ signal is sensed, the data {Ís transferred 
Moing tne alternate protocol described above. Finally, tse 
Mermination Status byte is read from the controller and 
Bed in tae common memory status byte, the registers are 
Mato red from the stack, the timer count value is re-loated, 
ENS return is executed. 

neg MpUcenpuptonandrien cand inirlalization routines 
memes :ioaded into memory and DDT86.CMD was used to manually 
Set the interrupt handler's common memory variables. This 
enabled extensive testing to de carried out and tne routine 
mes tOund to function as designed. 

A SIDO Lt cae interrupt nandler was reing 
Moaded into local RAM at tne top of tne transient program 
area (TPA). Because all users nave access to this area, it 
Moa. te quite a simple matter to write over or otnerwise 
alter the routine and thus, disable tne disk communications 
ESDpabllity. CEMO re practical solution Bad to be sound. It 
uc decided to place tne interr pt sandler immediately 
EN owing the return instruction of tne Micropolis INIT 
routine for two reasons. HIRST, because the routine would 
Bema part of tne operating system, it would not be as easily 
accessible by the user. Secondly. tnis “co=locates the 
routine with tne initialization of tne nardware used to 
mayvoke it. This makes ruture moditications to the routine 


or the technique easier. 
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2. Blocking/Deblockineg 

EDEN -ropo)is disk System was supplied, in part, by tne 
Digital Researcn DEBLOCK.LIB source file. Tome. file mIs 
supplied as a part of tne CP/M-S6S operating system. It 
mes a complete routine tor HOME, SETTRK, SETSEC, and 
SELDSE operations. READ and WRITE operations are also 
supplied but require tne user developed routines READHST and 
MLL EPST. 

The READEST routine tnat was aeveloped prepares tne 
memmand packet described in Section 1 above ara senas it to 
the common memory. Tne status byte is then cnanged to @ and 
ELM out)ne wdlts for tne interrupt handler to cnange tre 
Status byte. If tne status byte indicates "success, the 
Semon memory buffer is copied into a local sector buffer 
mae the operation is complete. Ptweerw error 15. i2cicered, 
LRS error flag used by the BDOS is set and tne common memory 
Aerer is not ccpied. 

POC wevRIIteSTe routine closely follows tne READEST 
Routine. First, a command packet iS prepared ana sent to 
Ee common memory. Deren taewlocal sector' butter is places 
in the common memory sector buffer ana tre Status byte is 
fem to Z. The routine then waits for tne status byte to 
cate success or failure and tne EDOS error slag is set 


E Urdinely. This completes toe write operation. 





Piescnomds DE note that in the READEST and WRITEEST 
routines, the status byte must be set to & only after tre 
command packet and common memory sector buffer (writs 
Merations only) are set up. This is necessary pecause wren 
Mea veT Supt occurs, tne interrupt nandler will use tne 
gomman? packet and sector buffer in common memory at that 
time. i newestarus tbyxuELLS sete to prior to preparine 
common memory, there may or may not be enougn time to 
Mmeepdre it. Detling tems tatiss ov be to 2 after tne conmon 
memory has been prepared ensures that tne intended operation 
EN I ba carried out. 

Mie ERBEOC ARIS “pomtines cited above were used in 
E enrtirety to provide the remaining aevice dependent 
routines. However, one minor alteration was necessary. All 
variable names were prefixed witn "MIC", Tnis was required 
because Alnquist and Stevens" work used tae same  rcutíines 


Mere the REMEX hard aísx [Retf. 5]. 


eee INTEGRATION INTO THE MULTI-USER SYSTEM 

a teerate tne Micropclis hard disk inte tne multi- 
NS ys tem, toe sever device dependent routines were placec 
ENS single file, MICHARD.AS6. Next, tne Disk Parameter 
EE was updated to reflect tne Micropolis disx unit. Eacn 
EN c" the tive drive heads was configured to be to a 
meercal CP/M drive. ROCerinatintoOelcal to physical device 


Meine for the multiuser system is snowa in Table 5.1. Tre 

















Logical 
Device 
Letter 


EXINLLL IT NM 
LR Umane ame 
A pmmneesa we 
ee 
A em 
Fe 


Physical 
Device 








REMEX Hard Disk Head 2 


ee 
ooo 
eae 
eee 
AA ern mann | 















Table 5.1 Logical to Physical Device Map 
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calls to REQUEST and RELEASE were placea in tne 2EAD and 
Mere routines, the label table file, CPYMAST.CFG, was 
Updated, and an “INCLUDE MICHARD.AS6” statement was placed 
moe ree BIOS module. Tne steps or Figure 3.4 were tollowed 
ema 2 a@w CPM.SYS was generated. NotComunaG oc tie Original 
tem of Almquist and Stevens, this rile was titiec 
"CPMMAST.CMD. It was necessary to change the name as a 
EM of other work aceomplisned during tnis research 
EN ort. this is discussed in the next section. 

The master conditional assembly switcn in tne BIOS 
module was set to false and a CPMSLAVE.SYS rile was created. 
The slave version is different trom tne master versicn in 
phat tne NETO polis “interrupt handler end nardware 
Ma lization, as well as tne intializaticn of common 
meamory synenronizavion variables, «re not included. 

When the system was —nrtially tested, ur wilodced 
Meoperiy anc only certain commands, such as DIR and REN, 
EU 5e executed. Commands such as PIP ana STAT would not. 
Ir fact, tne syStem would cone to a halt and required re- 
peoting wnen these commands were attempted. “any 
emeni nents were conducted in en effort to find tae source 
Mais problem. It was discovered trat only the  ^uilt-in 
Commands (DIF, REN, ERA, and TYPE) would execute. 

The difference between à built-in <oprand ani a 
wans lent utility program is that tne built-in comnanc 


Mesia2’sS in memory as a part ot the operating system waile 
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Bre transient utility program resides on disk. EMG 


a 


meansle€nt utility programs, like PIP, must first re loaded 
mm memory. This program then becomes the applications 
meogram of Figure 3.1. Any disk operations required in tne 
EMEN 6.5 Of executing tne program must be performed by the 
BDOS nodule. The applications program indicates that a disk 
Meme. on is required by tirst setting tne CX register of 
Meee SZS&5 to the appropriate function nuroser ani then 
executing the SOuuNa ce merialLerrupt number 224. When 
Maerrupted, the BDOS module will carry out tne irdicated 
Buncrlon. 

Mars conflicts with hardware interrupts. Recall Zrror 
NDter II, Section A-4 tnat a software interrupt is of 
Sameer priority than a nardware interrupt. AS snown in 
Meare 2.4, when a software interrupt is beire processed, 
Pe hardware interrupts are not sensed. A transient utility 
ueram Enters the BDOS py executing a software interrupt as 
Mescrited above to perform any reed/write cperatıon. in 
Bas implementation, the read/write operation for tne 
polis can be completed only if tne nardware interrupt 
Bccurs. Tnerefore, a deadlocx results. 

Tnis problem wes solved by executine an INT 70 
Meetruction on the master board wnenever a Micropolis 
read/write operation is needed. Lhis rorcee the interrupt 
handler to execute even though the entry to tne EDOS nas 


prevented tne nardware from causing its execution. Tre 


Se 






NIS I5 and CPMSEAVE.CMD flies were re-generated as states 
above and tested agair. Aiemconnanaw? tle .eCxeCuLions on tne 
master board were successful. A fout AEGIS System boards 
were then booted and tnea multiuser system was tested. 
Simultaneous operations conducted on these four voards were 
EEUU successful and it was concluded that the Micropolis 
disk unit had been successfully integrated into tne 


multiuser AEGIS development system. 


Early in tne development stages ot tne Mirropolis 
interface, it was discovered that a power failure would 
memproy tne conterts or bubble memory. Since, the operating 
system was booted from this device, work could rot be 
Continued until tne bubble menory nad been re-rormatted and 
pEetoaded with tne operating system. This is an extremely 
time consuming task and tne method is detailed in [{Her. 5, 
Es3pDter IV, Section DJ. Thus, 1t was considered cesirable 
ENS eble to boot load tne operating system from tne REMEX 
mroppy disk drive. A new doot ROM and loaaer routine were 
EEveloped for that purpose. 

1. Boot Loader 

Mom staver an Cnegter Lilie the SK byte EPROM chips 
etme 15SBC 86/12A contain the INTEL 957 monitor and control 
mmoessed tO tae monitor wnenever te system RESET putton is 


pushed. BO tao trae oubole boot loader and the INTEL MDS 


es 






meiommeooot loader Co Exist with tne monitor in tnis EX 
EPROM space. 

It was originally tnougnt tnat tne PEMEX boot 
loader could simply be added to tne EPROM. However, this 
was not possible because the space occupied by tne monitor 
severely limits the space available for programs. Tne EK 
BEROM chips occupy tne address space between @FE@YZE and 
QFFFFFH. Tne 957 monitor occupies the Space between ¢FEQGCCH 
and FFD22H and contains a set of jump vectors at tre base 
of this address space. This leaves approximately 72€ 
cecinal bytes of space for boct loader programs. It was 
Bea ar this point to maintain tne monitor ana INTEL MDS 
system boot loader in the EPROM and to replace the bubble 
boot loader witn tne cne for REMEX. This would preserve tne 
weri bility of being able to boot Load tne 86/124 from two 
Ae ersat systems instead of just one. 

A boot loader simply loads tne program located cn 
Ne served system Tracks of tne disk into memory and 
messes control to it. Itzuzche responsibility or this 
progran, tne loader, to loaa tne actual operating system 
imino menory and pass control to it. To develop a boot 
loader for tne REMEX would require tnat a working systen 
Nader be placed on tne system tracks of tne diszette. 
Since one had nct yet been written for tne REMEX, tne bubble 
erstem loader, LDRMBSY.CMD, mas used for development 


purposes. This would permit tne boot loader under 
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development to load the bundle system loader from the REMEX 
mloopy disk and this loader would then load the operating 
System from bubble memory. A boot loader program, 
RMXYROM.AS6, was successfully written, debugged, and tested 
sine this technique. The source code tor the INTEL MDS 
boot Nader was tnen Successfully intezeratel TA to 
RMXROM.AEBS. 
2. System" Loader 

moemy Stem tracKS orf ena elnele density, eient inch 
MODpy disk have 6.5K bytes of storage capacity and tne 
sten loader must be Limited to tnis size. To generate a 
loader BIOS module for the REMEX, a conditional assembly 
switch was adaed to the present BIOS module. foe switch, 
"loader bios", wnen set to true, only includes in tne 
E); the device dependent code related to tne REMEX 
Floppy disk drive. A new label table file and a new Disk 
memeameter Table were created. Toeeez tes, LIRMAST.SAC and 
MNMNAST. LIE respectively, refiect tre REMEX floppy iisk as 
the only disk drive in tne system. Tne steps or Figure 3.5 
were used to create tne loader (It snould be notea nere tnat 
meee LOCPM.CMD provided by Digital Research ror use in the 
EE. Expects to tind tne system rile as CPM.SYS and tris 
BEEN Lhe reason for the name change cited in Section C 
above). Tne resulting Loader, RMXLDR.CMD, was approximately 


DK bytes ana easily tit on tne system tracks. Tne REMEX 






system loader was debugged and tested using the REMEX boot 
loader as tne test vehicle. 
3. Programming tne EPROM 

With the boot loader and system loader routines 
complete, tne EPROM chips couid now be programmed. The Sk 
Memes of EPROM consist of four 2k tyte INTEL 2715'“s. 
Recause of tne even-odd addressing used on tne €6/12A, two 
Ore these occupy tne even 4 byte address space wnile tne 
other two occupy the odd 4K byte address Spare. lercause the 
EN space avallable for boot loaders is located entirely 
within the upper 4K bytes of EPROM, 11 was necessary only to 
modify tne two 2716's occupying tnis address space. 

PRTESZCHD Zuas used To read the contents of tne 
upper 4K bytes of the 86/12A°s EPROM ana this was saved as a 
ED file. Mean usins DDTES,.CY), tae existing boot loazers 
BEI x renoved from tnis fiie and tne contents of RMYROM.CMD 
were inserted. phaseresUircec 1nd sSTymele contisuous tile 
EEUSininege tne upper portion of tne 957 monitor, a boot 
mader tor the REMEX, a boot loader tor tne INTEL MIS 
ecem, and the jump vectors required by the 957 monitor. 

PMOmGOUG ISS mers Then written that split tnis file 
Into two files: one containing tne odd address bytes and the 
other containing tne even address bytes. Two new INTEL 
2716S were then programmed with the contents of these two 
files. Tne newly programmed cnips were placed on tne iSBC 


86/12A and tested. Ine INTEL MDS system was successfully 
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boot loaded by typing the command “GFFD4:¢ trom the monitor 


and tne AEGIS development system was successfully pooted 


mom the REMSX tloppy disk drive ty typing tne comnand 


"GFFD4:4" from tne monitor. 





VI. RESULTS AND CONCLUSIONS 


— ——— — —— Se e e — — A e m e r 


A. EVALUATION 

Two tests were conaucted to evaluate the performance of 
the AEGIS development system. TiC IS, eS COR is ted ot 
assembling a 6% byte file and recording tne assembly time. 
This was done for both tne Micropolis disk system and tne 
REMEX Data Warenouse with one, two, three, and finally, four 
EBomputrers operating simultaneously. Timing was accomplisned 
with a Standard stopwatch. Tne results of this test are 
Wow in Tatie 6.1 

mye, second test consisted of file transters usine tne 
ENPSUCMD file utility. DOSIS Tesents a worst case 
Situation as tile transfers are I/O intensive. Four 
Mmeeansier airections were tested:  REMEX to REMEX, Micropolis 
END EX. REMEX to Micropolis, and Micropolis to Micropolis. 
A single 27K byte file was used as tne transfer file. once 
INT. tne test was conducted with first one computer 
pera tiíne and then with two, tnree, and four corputers 
operating simultaneously. Tne results of tnis test are also 
SHOW in Table 8.1. 

As indicated by the assembly data, taere is not a linear 
relationship between the number of computers in tne system 
and the times required for assenbly. tacos. Wirth four 


memeorers, tne time required for assembly of tne 6K byte 
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Execution times ( in seconds) 


One Two Three Four 
Computer Computers | Computers | Computers 
Operating | Operating | Operating | Operating 


ASMB6 
EE | se omo | ea | se| 
ASMB6 
76. 


Mieropolis 
to 


to 


Micropolis 


Micropolis 
to 
Micropolis 


Table 6.1 Test Data 
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Ea ome nal ecco times the tine required wita just one 
computer. Moise Guaceouncec ror by realizing that, except 
for tne contention for snared resources (common memory and 
hence, isk access time), sach computer can assemble the 
meee independentiy of the otners. 

From tne file transfer data, as well as tre assembly 
merce, it is immediately apparent tnat tne BEMEX Data 
Warehouse operates taster tnan the Micropolis disk syster. 
However, tnis is Ot an order of magnitude as one miznt 
expect when comparing a DMA interfaced nard disk to one that 
is interfaced using programmed I/O. Me pen second 
polled interrupt (used to communicate with tne Micropolis) 
Na en into account, tae Micropolis performance woulea come 
even closer to that of tne REMEX. Tne reason tnat tne 
meoerenned I/O interface performance is closes to tnat of a 
eee interface is that more time is experded in disk head 


movement than memory access. 


B. GENERAL CONCLUSIONS 

Tne primary goal of tnis thesis was met. A haraware 
Bu rtace was designed for tae Micropolis disk drive using 
programmea 1/0 techniques and tnis was Suzessstully 
mevesrated into tne AEGIS multiuser system. Tne system was 
demonstrated with Tour independent users operating 


simultaneously. The addition of the Micropolis disk system 


to the AEGIS system provides an additional 35.6M bytes of 
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NIN Storage capacity and should prove to be more taan 
adequate for program and data storage. Tnis frees the REMEX 
Bund disc to be used entirely tor tne SPY-1A radar emulation 
rather than as a software storage media. 

A boot ROM was also developed tnat allowed loading the 
operating System from the REMEX floppy disk drive. Chis 
Eu ed to be more reliable tnan tre bubble boot procedure 
EE 3: tne Onset of this research. Tne busble menory 
frequently “crashed” and required reformatting and reloading 
before it could be used again. The cause tor this was never 
ENScovere43 except for noting that every time a power failure 
ocrurred, tne bubble memory would crash. Tne board has onr- 
Erg power failure protection circuitry. However, tne 
MA tes required ro tnhorouegnly test this circuitry were 
not available. 

Future research involving tne AEGIS multiuser system 
eeould include expansion of tae current EK EPROM to 16K and 
Mewetooment of a boot Loader that would allow booting from 
ery of tne devices in the system. AS tne current system 
mands, if tne REMEX floppy disk drive fails, either a new 
boot ROM will nave to be generated or tne old bubble boot 
RƏM will nave to te restcred. This may eventually prove to 
Bentoo inflexible. 

| Additionally, some type of protection scheme needs to be 
implemented for common memory. eureentlv, otnere 1$ no 


eao ection and a user program that has gone out of control 
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Sanda quite easily destroy tne data in common memory. Tnis 
development would require that some type of hardware access 


control be designed and tne BIOS module te modified to 


activate that hardware whenever common memory access is 


required. 
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USER’S MANUAL FOR THE AEGIS SYSTEM 


Pee SYSTEM CONFIGURATION 

Tne AEGIS development system consists of: one bubble 
memory board, four INTEL iSEC 86/124 boaras, tne REMEX Data 
Warenouse, the Micropolis disk system, and a SEX byte common 
memory board. These toards must meet certaln requirements 
Bu orier to work properly in tne system and these are 
@escribed in the paragrapns tnat follow. 

gee Master iS¥¢ 25/124 

Tonis ara. 1s used as tne “Micropolis disk unit 

mepertface and provides tne bus clock and constant clock 


ERenals to the MULTISUS. phis poard must ce pos!tioscec 1n 


ct 


the iCS-&€@ cnassis in an odd-numperea slot (the slots are 
numbered trom i to 16 left to rient). Tne board 
requirements are: 


Remove Jumpers; 


Mo 21€ ESE > 
515-516 Ecc eno9 
Ki7-£12 150-531 
E1 9-2 ES2-E33 


Add jumpers: 


no meh eee S517 
ES0-E25 


Add 7438 drivers in sockets: 


X411 XA12 
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mns wi et ùp tiese S255 interface for the Micropolis disk. 
Pomprovyide the constant clock and bus Clock: 
Add jumpers: 
E1g2-E124 E105-E1C26 
This board must also contain the EPROM cnips witn tne REMEX 
foot routines. The tinal requirement is that the local RAM 
be made inaccessible to the MULTIBNS. Tais is cone by 
woes junuUper E112-EI14 and removing jumper E115-E128. 
S Other {S30 G6/12A"s 
Tne remaining boards must nave local RAM 
inaccessable to tne MULTIBUS aad must not provide any clock 
Sredals. To make the RAM inaccessible, add jumper £112-EF114 
and remove jumper E115-5128. Tots able tie clocas Siznals, 
remove jumper E1%23-f1(4 and E1905-51€96. 
3.  REMEX Disx Drive 
The Remex controller boarı mus oe plugzed irto an 
EU-sumbered Slot in tre iCS-B£ chnassis. 
+. B3ubbie Memory 
Bubble Demory must L »Lweced into tne slot 
Eonrajninge the RUN/HALT switen (currently position 3). 
5. SZK Byte RAM Board 
This board can be plugged into any slot in the 


ENSSSIS and must be configured to start at adaress HECUAGE. 





EPSE ACTIVATING THE SYSTEM 

Pefore turning any power on, ensure that tre RUN/HALT 
switcn located on tne front panel of tne iCS~€¢ cnassis is 
meee the FALT position. Merti power-on tae equipment in the 
following order: 

IMME op power Lo tae 1695==é¿ Chassis Dy turning tne 
OFF/ON/LOCK key to tne ON position. 

2. Turn on tne REMEX disx oy toggling tne OFF/ON switch 
cuithe upper rient of tne front panel to ON. 

õe Activate the Micropolis disg by toggling tne switca 
EM he rient of its front panel to the up position. 

AS pin Up the REMEX disk by placing tne STOF/START 
NE located On the upper left panel to START. Tne green 
meen, over this switch will go out. 

meee cura on all CRT's. 

See Togele the RUN/HALT switcn on tne 1C$-90 front panel 
Do RUN. 

(A ess tne master 220537 switcna on the 105-8€ pagel 
Bn. This generally requires more than one RESET (normally 
maree or four). Tae -ineicator of a good RESET is that all 
CRT’s are printing stars and that the green lieznts over bota 
mem oTART/STOP switcn and tne A WRITE PROTECT switcn of tne 
REMEX are on. 

With tne power applied, tne next step is to load the CP/M-86 


openating system: 
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1. Place a system disk in tne REMEX drive FE (leftmost 
floppy drive) latel up and close tne door. 


2. From the CR? connected to tne master board (the one 
witn tne Miccropolis interface cable), type I. Tnis will 


activate tne INTEL 957 monitor. 

3. Enter tne command “GFFD4:4". The disk in drive B 
ul be accessed and approximately one to two minutes later 
the operating system will respond with: 

ENTER CONSOLE NUMBER 

4. Respond with the number on the front panel or tne 

mower ne nert request will be: 
ENTER LOCIN DISK 

Dr Respond with tne desired disk. Tnis will de tne 
only disk that you will be permitted write access to. 

5. Tne master board is now operational. To activate 
meee remaining boards, first locate any disk drive that 
contains tne following files: LDBOOT.CMD, HOOT CMD. 
PEMSLAVE.SYS, and LDCEM.CMD. Anen pe the commands 
"LDBOOT" and "LDCPM" from that drive. Next, type 'U from 
EN nDInitiailzed toard to activate its 957 monitor. Enter 
the command “SE@¢¢:4uu". AS with the master board, you will 
DNEgUeried for a console number and login disk. Reply as 


with the mester board. 


C. DE-ACTIVATING TEE SYSTEM 
i Ensure that no floppy disks are in the REMEX and 


that all users have finished. 
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2. Press in tne master RESET button on tne iCS-8¢ 


enassis. 


EE Place rne RUN/HALT switcn on tne front panel of tne 
mene chassis to the HALT position. 

a Turn olf the Micropolis disk unit. 

5. Place the STOP/START switcn of the REMEX disk in the 
Mor position. Tne green lignt over tne switch will so out. 
meen the light comes back on the disk nas stopped. when 
meas occurs, turn the REMEX power switch to OFF, 

EE Turn tne power off to the 105-80 chassis. 


e Tura off ali CRTs. 


DN CREATING A SYSTEM DISK 
eer rerSty former ınematsz,. This will nave to pe done 
on a CP/M compatible system as tne AEGIS system currently 


Mes no formatting routine. 

2. Activate the system as described in Section E above. 
Brace tne formatted disk in tne REMEX floppy drive E. 

pe) Lorate aye drive With tne rollowine tiles: 
EE CMD, RMXLDR.CMD, CPM.STS, and PIP.CMD. 

4. Issue tne command "LDCOPY EMXLDR.CMP" from tnis 
drive. Our ya pe queried as to which drive to write te. 
Respond witn "R'. 

Eee Finally, issue the command PIP B:=F:CPM.SYS (Note 
nere tnat "FT" was an gebıtraryzscenolce, dS any drive with the 


Beecitied tiles on it will work). 


an 






6. You now Rave a system disk. It can. te tested 
mowing taelactivation procedures described in Section E 


above. 


E. MAINTENANCE UTILITIES 

Pieesystem currently contains maintenance utilities for 
the bubble memory, the REMEX Data wWarencuse, and tre 
Beeeropolis disk system. These are aescridea below. 

1. Bubble Memory 

Geere ware two system utilities for maintenance of 

ESsbubble nenory: DIAGSSGM.CMD and MBBSIFMT.CMD. DIASYEM ı5 
a Self test of the bubble and requires no user input other 
than the command “DIAG86" to activate it. Any faults 
Meemirri n> during this check are reported to tne console. 
MBBEOFMT ToS edito formait the — bubble For a CPAM 
envircnment. Tne user will be askec to enter the base 
address of tnae controller. Respond witn  "BCCCH". Tne 
formatter will then format the bubble memory. 

2. REMEX Disk Drive 

Two routines are also available for the RIMA: 

BEEXMAINT.CMD and RMXFORMT.CMD. Before eitzer of tnese 
tines can be Successfully executed, the local RAM of tne 
board executing them must ce made available to tre MULTIRUS 
Ne se routines were not written to pass information 
through the zommen memory. Therefore, jumper 5112-5114 must 


removed prior to execution. RMAMAINT is menu driven wita 
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meoe available functicns. Select the function from tre list 
acts console and enter that number. Since tnese routines 
meen Carried out by the firmware of tie REMSX controller no 
other user input is required. BEREORPFT En] format the 
REMEX for the CP/M environment. You will pe queried as to 
which  "nead" of tne disk to format. The nead to CP/M 


logical device iS given in the frollowine list: 


Read Y Drive D 
Fead 1 Drive E 
Head 2 Drive F 
Head 3 Drive G 
Select the desired nead number and enter it. No further 


inputs are required. You will. be notified at ue console 
when the formatting is complete. Restore Jumper lie ola 


after completing all desired maintenance on the ZEMEZI. 


Tne Micropolis has a single menu-ariven maintenance 
Beeerar, MICMAINT.CMD. Tnis program must be executet only 
meme the board containing the Micropolis interface. PROT 
to runnine it, ensure that all other system users are log£e1 
into a non-Micropolis tisk. The Micropolis "neaa” nunber to 


CP/M lozical disk is given telow: 


Head @ Drive Y 
Head 1 Drive I 
Head 2 Drive J 
Head 3 Drive K 
Head 4 Drive L 


Mere are two types of commands in tne menu: initialization 


ema, tornattine. menait alization commencs prepare tne 
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IO Se anA Verify tnat taere are no surface defects. 
Tne fornatting commands prepare the disk for tne CP/M 
operating system. DM. gesrred to Dun a initialization 
type of command, six values will be requested. These values 
are described below. 

à. Physical Address of Logical Sector £: 2n15 
ons tor a variety of logical sector mappings on tne disx 
meselt. In tris system However, this value is currently 2 
and tnis should be tne response used. 

b Sector Skew Factor: mais enables tae sector 
address to be physically skewed on tne :isz. Currently, the 
CP/M operating imposes its own skew factor and tnis valve is 
also set to 4. 

AO HE Spare: The Micropolis mas a 
Sector sparing capability. Ir a Dad Sector )s founa"durine 
[eeeralization, tne spare can be written in the bad sectors 
meee. Until a bad sector is noted, tnis value is 24. Inis 
Reel write the spare sector at tne end of the track (sectors 
DEL 25 are tne only ores accessibie by CP/M). 

an Disk Fead Number: Hcepono wite tne q1esifeg 
head number from tne list given above. 

ens tartcinge "Track: Toe MIOT polis nas SEXO total 
tracks per head, numbered from V to 579. Enter tre desired 
Bearting track number. 

indias Track: Enter tne desirei ending trace 


number. Tne selected command will be executed on all tracks 


lec 





between the starting number and ending number. The forrat 
commands only reguire the last four entries from the list 
moove with the same conditions. AIL fornat or Initialize 
commangs should be followea with the corresponding verify 
mormat/verify initialization command. Tnese require tne 
same entries as for tne original command and ersure tnat tne 


NEN unctilon sejlecred nas been properly carried ovt. 
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APPENDIX 


Itc 


PROGRAM LISTING OF MICMAINT.AS6 


MPCMAINTDISSO 


;Program Name 


;Date ESA TITS 

¡Written by Marx L. PerrTy 

¡For Thesis (AEGIS Moaelirg Group) 
meavisor Professor Cotton 


Cilsetouyrromeaavles tne initialize tion 
ano tormertimesruncti0ons To bs carried out 
for taenMicTopolis Disk. It 1s ¿omplertel; 
Nenu-äriven ang explanatory ir rature. 

XE IR IR XK IR IK IK AK IR IK IK IK IK IE XR IR IE IK ZE IK XR IR IR o 


EQUATES TABLE 


fm urpose 


we Wt we we we we 


csee 

org len 
; p————————————————————————————————————— D D D o es ee Se es oe es r ee oe r 
; MISCELLANEOUS ECUATES 
H 
cr equ van 
Ir equ dan 
wip equ lah 
be equ m 
, — — — AM A ee ee gre uu ee ee ee es es ee es ss es es os E CS E E E a am 
j MOUATES FOR #255 PIO 
; 
porte equ ¿cen ¿command port 
porta equ PH "Dle2gdirocUvtonal 
portb equ ¿can yout uut port 
portc equ ccn seontzol/status 
mode 2 ¢ out equ Ceen mode, 2or 2255 
; ————————————————Ó——————————————— 
; RDOS FUNCTION ECUATES 
; 
ddos equ 224 pocos interrupt 
bdos £ equ € y DOMO 
Dpdos 1 equ al sonar input 
aos _9 equ d odos Strine output 
tdos 132 equ 12 ptdos bufter input 
, oe n ut GO ee ee SU am ee oe ee ee ee ee ee ee ee ee es ee ee ee d r ee e e ee e e e we es e e e e e 
H MICROPOLIS EQUATES 
j 
meer pb on equ 2007191070 ‚nead siengl 
Bsurb off S ece2zecel20 Wead Sianal crf 
Ero on equ CECEC11¢o write signal 
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Bott) oft 
mic stat 
Nic cmd 
mic data 
SI rb_on 
TD of Y 
ack On 
ees ort 
en sel 
stndrd 
Peay mask 
ordy_mask 
busy mask 
mask 
attn_mask 
areq_mask 


Erritial cmd 


verify cmd 


Eur ver cmd 


format cmi 


zer form cmd 


“Do... We 


main: 


main 1: 


main 2: 


equ 007007 1eb 


equ o0020200v7b 
equ 207200€7 70 
equ LLEEBELEID 
equ e2020 212b 
equ LÖLLZEIID 
equ CCOECL LUD 
equ COOLIO 
equ DOGC CKC LC D 
equ 200181105 
equ CC¢CEC109 
equ KOG dog D 
equ CLVZ1ICZLLS D 
equ 10104V40LCoD 
equ 10CC09000 
equ CO1ILLLESD 
equ 110104215 
equ TI2T710]1b 
equ 11077200870 
equ G1¢@G111b 
equ 2122060110 


“ain Program 


cat 


mov el, Dados 9 


mov dx,offset menu 1 


int bdos 

mov cl,bdos 1 
int Daos 

mov an,¢n 

cnp al, 4” 

jo main 1 

emp al, 6” 

Joe malin z 

mov <1,9205_9 
mov dr o tset err I 
int bdos 

jmp main 

sub ar, sen 

mov cmd type,al 
add al,al 


HOV Steer iset jmp_taodl 1 


add bx,ax 
mov cx, [bx] 
jmp Cx 


mov cl,tdos 9 


mov dx,offset end msg 
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write signal off 
sstatus signal 
command sigral 
¡data signal 
pinout, later sieral 
jlatch signal orff 
;output sigral 
soutput signal off 
‚select enable 
‚normal reset 
‚input ready 
JOUTput ready 
;busy 

Tauern cer sored 
eG Oy, 

;dreq only 
»1onbrroebps2e come 
IVER y ema 
sinltlelilze and 
‚verify ema 
stormattine cmd 
‚verify tne format 


fl tera li Ze diste 


youtput first menu 


szet user option 
‚clear an 
alae tury. 


¡Output error mse 


sand Start over 
saadust Tto binary 
¿Store commana 
sad) OF tol entry 
meet ‚ump- vector 


sand Jump to ioc 


send of session 
;»msz 





int bdos 


sti nnoe-erdpNB nU 
mov OTRE oe len =) O NCC D 
mov dl,¢d¢n 
int odos 
descr: 
mov al,@ a Ze count 
MOV ORO Set mo tab! 2yo0utput description 
Hescr 1: mov dx,[bx] 
mov cl 0dos_ 9 
pusn ax nea the erent Sterns 
DUSE DE 
int Ddos 
mov ¢2,009S_1 walı on. user 
int Ddos 
pop bX pros vOte ihe Dess 
pop ar 
aCe DUE Nu SD Orea Ot 
emo al, ¡description 
Je main TENIS LALO ST 
ada bx.U2 ¡else get next msg 
Jimprdeser 1 sana output 11 
fever _dsk: 
salio sec num ‚get logical sec C 
call skw num JESUS Kew fac tor 
Cai spat loc secet loc Cr spare 


fm ver dsk: 


Cari nead num EE Gead nun 
mov cl,baos_9 utput prompt 
MOveteeortSet mse 5 OT beeinnine 


int 0005 S numeer 


"-9 99 «9 ey We 99 
Jg c* C OR 


call tre num era: 

nov oeg TEX nun, ax SLOTS “it 

MON CDAS > ‚output prompt 
MOV ir Orset nse 5 ¿20 andinz 
fot tds ‚LU 2ack mumper 
call trk num sel it 


cmp dx,Deg trk num 

E dst 1 

mene ax,bez LTE num 
Em ver_dsx_1: mov end [rk aun,dz 


main_S: 
mov Cl,ocos 9 ¡output second menu 
nov dxyottset menu z 
int odos 
mov elsbdos-1 „get user option 
Int aos 
mov an,V7n yoblcorswn 
cmp àl, “0” valid ertry? 
Jo main_¢ 


enp al, Es 
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e cmmd 1: 


ENcmma 2: 


eS cmmd 2a: 
e cmmd 2b: 


e cmmd 2c: 


joe main 5 

mov tl ,bdos 9 
movodr,otfset err 1 
Tp DS 

imp mein o 

sub al,3ðhn 

ddd alal 


Mov DIO tset jmp_tadi_ 


add bx,ax 
mov cx,lbx] 
np ox 


call rev 
jmp main_3 


Gall! end 


jmp main_3 


mov cl, olos 93 

MOV GX eor1sSet warn 
irt Ddos 

mov. cljudos 1 

int tdos 
cmp al, y 
j2 2_cmmd_1 

cmp al, f 
Jasezenmd 1 

Jmp main 

emp ema type, 
Jarercnma zZ 

call pic conyl 

mp e. coma _S 

Gall mie conve 

mov cl,baos_9 

BomeaX ,of.seLums2 E 
int Ddos 

calli mic send 

calil mic starus 
Cesta al mask 

J2 e cmma 29 

postal arte mask 
Joz e cmnd ec 

mov al,40e5n 

cali nic tata our 
jap ezzmma 2b 

earl tae busy 

Gale nme indy 

cari mic dita _in 
emp a1,20n 

Jrz cmmd err 

inc bag tr num 


5 
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jolrtout error msg 


ydndeeraru drain 
saad just to binary 
sadr ON TOL entry 


Sees Vector 


¡Output tne review 
Second menu agair 


szet the change 
;secord menu again 


¡Output warnine 


;get response 


‚start over 
(Check tor connand 


‚p’2pare paranetars 


¡Output message 


‚send Darameters 
Satin ar reg 
jattr? 


¡must te dreg 
¿send E2n 


wait o catri 


22t term byte 
‚success? 

‚no, tnen error 
sary tracks leti? 





mov dx,teg_trx_num 
cmp dx eadi tre num 


ja e_cmm4_ób ;finished here 
„sosstrar: over 
mov parm2,dl ¿adjust parms 


mov parmö,dh 
¿Mp e “emma za 


e_cmnd_s: Mov cl bados 9 pout puc message 
Mov dr Offset TSe lt 
int bdos 

e_cmmd_sa: Co os end ¿send first parms 

call mic. busy ‚walt for cntrl 

Can emi Ira y 
coll data in ‚get term status 
emp dle ssuccessi ul? 
jaz cmma err LOW erBor 
inc 5ee trk num smore tracks? 


MONTADOS EME AUN 
emp dx ‚engserx num 
ja eTenndaz35 


mov parm2,dl sadjust parme2 
mov parmö,dn ‚and parmj 
jmp e_cmmd_öa 
Bucmmd ód: mov cr tdos 9 soutput success 
mov dx,offset msg 1l message 
Tou) 020s 
jmp main ¡ant start over 
cmmd_err: MO Vane ere OC. © gat ‘Save error 
canino cue rr "process it 
jmp main ¿Start over 


y FAA IEIR IE IK IE K HE HE IK IE IK A AK BR A IR AE IK IE IR IR NE IK IR RAE IR IK AE OK AE BE OK AE FE OR OK AR OK OR OK AK OK OE 
Moron tine: proc_err 

momury conditions: an error nas occurred in the execution 

H MoMa On tne cis« 

¿Exit corcitions: “proc_err_tatl” nas seen updated 
Registers altered: none 

Noa tines called: save,restor,bin_decs,dec_asc,mic_busy, 


; Drcercdymtc data in 
wescription: 
H T TIE TEE as Console output 


the details of ar error condition as issued py tne 
MS: controller. 
; 


prec err: 
call save savezsıllre>isters 
mov b1,@ yeetavpDucounter 
[oc err 1: CU EmICEDUSY snglt or cntri 
cali mie Iray 
cano data in JE eur etatus 
ine Di 
emp.Dl,o ys tt otn ore? 
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Je proc err z 

Jupp roc Str) 

mov dl,al 

mov dn, egen 

call bin dec 

IT 

mov asc_sec,di 

Mov asc sec 1,08 
movcasc sec 2, 0i 
mnovedisnesd 

mov dhn,€0n 

call bin 4ec 

E SE 

mov asc dx head,dl 
Moy asc drk ngad 1, tn 
NMOVeacc sd heuedd 2, ol 
mov dx, Deg Irk nur 
Cali “bin dec 

Cai eee ease 

roy asc trx,;dl 

mov asc tr& 1l,bn 
MOV Ta Se GLK 2, of 
möv dl, err code 
mov dn,¢¢na 

E dec 

CMM dSc Asc 

Mov aSo ET? Cdl 
mov asc err C 1,to 
Mower sie Ser nec 2, Dl 
mov cl,bdos_3 


Bror _err_2: 


‚put seetor in. 4l 
‚clear an 
‚convert it 


‚store it 

‚ger head number 
sclear in 
convert 11 
„store it 

sgzet traecı number 
Convert lr 
‚store it 

;zet error cole 
‚clear adan 


‚convert it 


store it 


‚output cmd type 


mev dx,offset procerrtatl 


int 6d408S 

"nov an,¢¢a 

mov al,cmd type 
add al,al 


clear ar 


yadoust tor tıbla 


movabr, otıset jmp tabl 2,2et jump vector 


AMADA aT 

Ow drat cx 
noy cds. 9 
int bdos 

mov cl,bdos_9 


output 1t 


‚rest of table 


novogrLIset procerria btt 


int ddos 

mov cl,bdos_1 
int Ddos 

call restor 
ret 


Sudroutine: mic_dusy 
Entry conditions: none 
Y 


we we We we 


„wait on user 
sto read it 
restore resisters 


SE KE IR IK IR IK IK IK KENE IK IE IR XE IK NE IR IE KE FR NE XE IK KENE IE KE KE RE IE IE NE XE FRE AS TS NS OK IK AS IIS RAK OK IK KE IR FE XE FE IR IEIR FR XR FR 


xit conditions: disk controller has issued “rot busy’ 





, Sd mna 
;Registers altered: none 
moeproutines called: mic status 
‚Description: 
mme executing program will wait here 
until the disk controller issues the “not busy” signal. 


owe we 


) 
mic busy: 
pusn ax ¡save ax 
mee busy_1: ea inme Status ¡281 Status 
Test adi ,ousy mask y busy? 


jz mic ousy l 
pop ax 
ret 
S SAAE IR IE IE IR DE RE IE EE AE EEN OK IE IE IE E E E BK AK NE AK AE IK A AE DS A AR ARA CRA ORF AES IR AK ORB FE OK OR AS OR FAK OE OR HE 
Meuoroutine: mic_irdy 
meotry conditions: none 
Exit conditions: disk contrclier nas issued ’iray’ 
signal 
Registers altered: none 
Eubrourtines called: mic status 
[Sscription: 
Ee erection Of the program will 
wait nere until “irdy” is issuea by tae controller. 


SJ owe we we we we we we 
< 


HT L 
pusn ax ¡save ax 

fc irdy_1: panic status ‚get status 
test al,iray nask ;ready? 
Neue ray. 1 
pop ax ¡restore ax 
DO iready now 

o EME NE AE ENA EME NER NDS AE 


IREO L 1.065 mic_oriy 

sentry concitions: none 

meet conditions: dis controller nas issued tne ‘oray’ 
Signal 

mersters altered: none 

EEocutines called: mic status 

Escription: 


à 


TNezereeution 0: tne program will walt 
here until “ordy” is issued by tne contreller. 


9 9 "99 we 99 «9 96 9 
WM tu 


, 
me ordy: 


pusn ax ‚save aX 
meee ordy_1: Call nite Status ‚get Status 
rest al.ordy mask ‚reädy? 
Eme ordy i snot yet 
POD af 
ret 
g RAE MERE AE HE HE AK AE AE AS AK AR AE AE A AS OE AE AE AE AE AE ARNE AE AE AE AE EAE AE HE FE KE RE DE SE DE SR FE DE DE SE IR BE AE RAR DE FE REAS AE AS E 





fouoroutine: nic send 

NB try conditions: parameters are calculated and in 

H the byte variables 

Nur conditions: bdramerers and command nave been sent 
Registers altered: none 

;jSubroutines called: save,restor,mic busy,mic ordy, 


; MeT Mle T Cema aut, mic dara out 
mescription: 
j The command byte, Six parameter tytes 


Ne eo byte found in the deta area are sent to 
Ane disk controller. 


) 


mMucesend: 
Gall save ¡Save TSelsters 
call mic oussy malt wor entr 
car emu com 
Gall mic ema out ¡sena out cmg 
H E of SiS Da rm l jserd parameters 
mov dl,¢ TCOUn Der 

mee send 1: call mic busy pwalroftor cutrt 
call mic Toriy 
mov al,[px] iget parr 
conri ea ta Out ‚send it 
inc Ox 
ioc ai 
cmp Al,” ; done? 
Joanie serdi I 
call restor restore registers 
Ger 


STE IRR AE RE IE IE IK AE IX IE FE SE IE IR RE E FE IE RE NE XE IK IR IE RE AE SK IE IE IK IE FE IE IK IR FR FE IR IE IR XE IE KE FR I IE IE FR IR IR IE IE OK OE KÈ 
soubroutines mic_cma_ out 

¡Entry conditions: “ordy” signal nas been issued py the 
disk controller and 'cmd tyte" 
controlas tre command to be sert. 
Brit conditions: none 

;Registers altered: none 

¡Subreutines called: none 

meescription: 

Tne command in tne byte variable “cma_tyte” 

mea Sent to tne cist controller. 

, 

IucEcmd out: 


“se we 


we 


pusn ax ¡Save ax 

mov al, cmd byte 

Out oor, apa) PONSA rec TLonad 
mev al mic cma A lire 
out porte,al 

moy aacr on ractivate output 
out porte,al ¡buffer 

mov al,westrb on spllseztne write 
QUE DOG tO sat strobe 
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mov al,wstrb ort 
ut Don Dal 


mov al ,ack Off ‚dezactivatrertze 
on porve.a lL ‚output burter 
pop ax 

Bert 


BE HA SRS NE AE A AA AR AEE AS AB NS Ae HE ALAR AEE RAE NERC AK RE RSE AE AE ASAE AE MOE HCAS IE AR RE A AEE ACHE RRE AIR 
Poubroutine: mic_data_in 

;Entry conditions: “irdy” signal nas been issued by the 

t qisk controller 

Et conditions: ài contains cata byte 

¿Registers altered: al 

‚Subroutines called: none 

Description: 


> 


; Ayer data is input from tae Micropolis 
mask unit. 
, 
mee cata in: 
mov al,mic data ‚enanle the data 
OR DOTLE al 
MOVIES To 0n ; tu 
OUnULSpoORtb5.d]l ‚on 
HOY al Stre 01 slat 
Cut porte ,ai 
MOV aL tTO Off 
Out DOTTE,ål 


BREtne reec 


Coyne +cat da 


moval, rstro ort stuzsn oft the 
out Vier Dal spread signal 
In a OD La ¡De data 
ret 


9 7 RIK AE AK AE HE IE E IE AE RE MA A EIE IR I IE IE K IE IE IE IE IE IX IE AR IR EI IE AE IE XR XE IE FE IE IE IE IR IE FE KE E AE 3 IR IE ET 
EUubroutine: mic 3ata out 

¡Entry conditions: 'ordy' sieznal has been issued oy the 
Icon tiro dier enc al contelrs value 
to De sent. 

meet coriitions: none 

;Registers altered: none 

scubroutines called: none 

Description: 


se we 


y Ao Emo data is Output to tne Micropolls 
mest unit. 

j 

fee data Hut: 


pusn ax ¡Save ax 

out porta,al to Olsdirestional 
Morelo mic data jenot ro gata tine 
out porte,al 

mov al,ack_on poet vate OUT DUT 
OMGe porte ,al ‚tufzer 

moy al wstrb on npupsectne write 
out portb,al ystrobe 
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mov al,wstrb_otf 
eur Dontb,al 


Mov aM acer? ‚ae=activetre 
OUISDORUSS 3 POUT DUT buUrirer 
pop ax “restore a e 
Der 


9 IR AEIR IE RE IE IE IE I IR BK AE AE BF BK XE RE FE AE E AR FE FE SEIR RAR AA AE A AR IIE IE KE AE DE KE IRAR FE E DE SE BE AE NE TE ACRE BE IA AR RE D 
jSubroutine: mic convi 

ntry conditions: none 

NT coniditlons: parameters are set tor disk use 
Registers altered: none 

Subroutines called: save,restor 

;Description: 

; This subroutine prepares the parameters 
meeguiaread by tne Micropolis disk drive tor verify or 
munitialization commands. 

} 
m 


me convl: 


call save ¡Save tre registers 
mov al,cmd_type sen ons Tor e onran 
emp au? e 

Jz mic cConyl_ l 

Cm aL ‚verity? 


lege icc Oy lc 
Densomesoyve,init Ver cme sinitlalize 


Mp mic convi_ 3 sand verity 

Dc convi 1: Devzsemase/te,inzitialrcma,itz was Initialize 
Pap mic convi s sonly 

mec convl 2: mowmomdebyvrte.verity cmd ,11t was verity 

mre COnVl 5: MOV wal. ead orerar Lead TUT 
mov C1,4 
Sam aec 


mov parml,al 


mov dx,tegz trk num ser UD parameter 
mov parmz2,dl i2 ard 3 

mov parmó,ih 

mov al, log sect ¡Seto parameter 
mov parm4,al ‚4 

Mov al, SKW Tac ‚set up parameter 
mov parma,al > 

mov al,spar ‚ser üp parameter 
mov parm6,al ‚6 

move ombre. J wool. uD eo byte 
call restor ‘Restore resisters 


a 
MN nennen 
gUubroutine: mic conve 
Mn try conditions: none 
;Exit conditions: parameters are set for disk 
‚Reeisters altered: none 
‚ssubroutines called: save,restnr 


x 


BK ARIK STK AC AE HE 


Je 





‚Description: 

H SSI U EI Drepares the parameters for 
ITE GT als: arive for format and verify format 
scommands. 

’ 

mic_conve: 


call save ‚save the regs 
Pov al, cmd type 
emp al,s ‚format? 


Je Miceconvec 1 
MCV eCMOmiyTe, ver form _cmadsmusct be verify 
Sip Mic conve _e 


mie conv2_1: mov cmd byte,ftormat cmd 

muc conva. 2: mov al,nead ¡Setiparemetes I 
mov ci,4 y;adjust position 
Sot ac] 


mov parml,al 


mov @2%,0ce2 tres num Si parameter 1 
mov parm2,11 sard 2 

mov parm3,da 

mov parm4,J is tartine sector 
mov parm5,24 ‚process 24 

MOV Darmo, y ynot used 

mov go byte,ð 

call restor ¡restore registers 
rer 


r 8 FE RE FE IE NE HE AK AE BRAK RE AR OS AK AE AS SRK AE AE AE AE OR BR E NE SR SR IE XEFE IE DA RE XE DE SE KE IR AR ARSE REAS KE KE RE BE RS SE AEIR RE SA RS FS SR 
Eub5routine: mic init 

mentry conditions: none 

BEI: conditions: disk sas been initialized 

pregzisters altered: ax,crx 

Bemeroutines called: mic_status 

ESscrivption: 

MoS SOROA ne resets end initializes tne 
Metropolis disk drive and trae 8255 parallel i/o port. 
meeeths reset attempt fails, the program is atorted ard 
mememuséer is returned to tne operating system. 

’ 

fre init: 


c »ileabtlesmaecabls 
pimreprupcts 
mov al,mode 2 £ out ;initialize to mode 
Gut porte, a! Ud e 
mov al,acx_off ‚insure acknowleige 
out porte,al yis Off 
mov al Stiro Off sinsure strabe 
out porte,al ESEON E 
Mova menr sel ¡et selec, anc 
OUT Dor tb,al ;enable 
mov <2x,10 jwa t 1isecond 
mre init_1: MOV dhe ners 


BIZ 





mec init 2: dec ax 
Jez Mic init 2 


dec Tex 
UncemPceenbt-I 
Saree emo uss szet the status 
cmpecal!,S Lud rd 
o AS stanenrreturn 
mov rel bdos 9 ‚outpur orror 
MOVE rO set mierst err,messaee 
int Ddos 
mov c1l,2e sand return To 
mov dl1,€£ 30/5 
rat odes 

mec init_s: vet 


e ARES 
Pouoroutineé: mic_status 

¡Entry Conditions: none 

EXIT Conditions: al contains status of disk 

Registers altered: al 

¡Subrcutines Called: none 

‚Description: 

; Tnis subroutine reads and returns the currert 
myaiue of the Micropolis disk controller's status port. 


) 
fee status: 


mov al,mic_stat pene Dic stat dine 
Quit porte, al 

MOV, TStro_ on sturn on read 

out, Dertt,al 

mov al,stro_on pletGca tre status 


out vorte.al 
mov a lesyrp_ oft 
out perte,al 


no astro Orr raro reat 
oürt portü,al 

in aly porta Onine in Stratus 
DET 


G FE AR IE SEDE NE REFE BK ORE SK BK E IAIK IE IE FE NE IE IE IE IE FEDE IE IE FE BE SKI AE BK EE BK DE IR XE F FE IR IE FE IE IE AS FA FE OR OR AK OR ATO OE OS 


gubroutine: che 

ntry conditions: none 

„Exit conditions: desired value is changed to new value 
‚Reeisters altered: none 

Bemoeroutines called: save,restor,log sect num,Skw_num, 


, spereloe acad nüm, irk nüm 
mescription: 
H Tnis subroutine allows the user to cnange 


ja Value trat has been previously specified by a call to 
‚the appropriate routine. 
) 
gne: 
call save Save registers 


IIS 





Cp cma ty oe .2 ptwosdutfcoprLs 


ja cag_& ¡depending on cmd 
che_1: movre lodos 9 ‚output menu 

mowedrs,oftset memu 3 

int ddos 

mov cl,0dos I seet user option 

int bdos 

mov an, Ln Pelearean 

cmp al, 2” jvallia entry? 

JO cng 2 x 

cmp al,°5 

joe chiens 
Eng 2: mov Cl edos 9 ‚output error 

MONOS ET err 1 

int bdos 

mp cne l pana startzaver 
eae 3: suð al,óðr convert to binary 

dada. aljal AUST or table 


mov DX odr etemo tanl Siget Jump vector 
add bx.at 
movere Dx] 
jmp cx 

Ene 4: mov E 0d 0S 2 ‚output menu 
HOVeGmeOrtse. Nenu 4 
int odos 
mov .21,590571 ‚eet option 
int baos 
mov an,@n poled ras 
cmp al, o“ ¡valid entry? 
RS 
cmp al, 2 
Joe cen225 

ene_S: mov cl,bdos 9 ‚output error 
MOV Gomer. Set err 
anit oes 
jmp cne £ 

cng 6: sup 41,803 jcomvert to binary 
add al,al ¿adjust for table 
MOV jmp taol ©,zer jump vector 
ada ox 4 ax 
Mov pod 


jmp ex 
che 7: cari los esc? num er uewelosical 
jmp ^ne 15 ¡sector number 
Ene 8; call skw num ‚get new skew 
np. che 215 ;factor 
cng 9: call spar toc Jeevan ew Spare 
gmp che 15 slocation 
che 1¢: Saeed denM ‚zei new nead 
np che 135 ¡number 
ene 11: [noc du od OS 2 ;get new bezinning 





IG nse_23 ¡track number 
ict bcos 

Cael Vee UT 

CMP Arredi rr num 

Joe cn? 1le 

genesdx,erastrk num 


ene lla: mov bee _trx_num,dX 
jmp cne_13 

eng 12: may ci tdos 3 ‚set new ending 
mov dz orfset mse oO ¡track number 
int bdos 


[as NO 
cmp dx,Deg trk num 
Jae chess 
xchge dx,bes trx num 


che 12a: mov end trk num,dx 
chg 135: call Testor HEeS ore reris ters 
Trey 


IE STO AE SERE IE RE E A EE ERE AEREE REEE IE FE SA SERE SE A RE E SENE BE RE XTE SE IE KE SR RERE AE SE RE AEA S E SA AE BE SE FE 
¡Subroutine: rev 

B utry conditions: none 

merit conditions: none 

yRegisters altered: none 

Momoroutines called: Save,restor,bin dec,dec asc 

Na sscription: 

y Tois subzceuriresprints out at the console a 
scomplete tabulation of user Suppliet input and 
maeyurns to tne calling program. 

3 


rev: 
eallzssyve cave all regs 
mov dn,@@n ¿Convert logical 
Mov alos sec e ¡sector LO asc 


Calin aec 

Call a2c asc 

mov aSc log _ sec0,A! SOS It 

mov “ase log G DD 

mov asc loz Seco 2,Dl 

mov dah,den ‚convert SKow 
mov dl,skw_fac factor to asc 
ep nedec 

Call dec asc 

mov asc skw fac,di ISLOTE It 

Moveasc SEW fac l,bh 

MOV 325C _5KW_1a2 2,01 

mov dn,¢@n seonventT Local ton 
mev di,spar ,0f spare to asc 
Call Seine? 

condes ias 

mevzasceaspar,al ‚store it 

mov ase Spar i, dn 


LES 





mov asc_spar_2,bl 
mev dn,? 0h 

mov di,nead 
conde 

call deco asc 

mov asc nead,d1 

mov asc head 1l,bh 
mov ase head 2,01 
mov dx,beg tr& num 
Cali lime dec 

Gall dec asc 

Mov asc bee trex ,ci 
MOVIedsG soem. ETE 1. On 
meV asc Des trk 2,01 
mov dx,end_trx_nun 
call Din EC 

cod dec asec 

mov rascsenletrk,dl 
mov ase end tr 1, cn 
Mov laSe ent trek 2, bl 
mov cl,bdos_9 


mowsax,ot'set Tev_tabl 


NETO OS 

mov an, 

mov al,cmd_tyve 
add al,al 


Wor wc omurset jmp ta Cl | 


aod) Dax 

Mov dX., (0X) 
mov Cl, 0dos_ 9 
int b20s 

No ze 1210408 23 
cmp endarype,2 
ja svo 


SH 115E 
‚nead to asc 


sStore It 
‚convert beginning 
strk to asc 
store it 
‚corverr engine 
strx to asc 
sstcre it 

sOutput commana 
FUNDE 

‚cleer an 

;adjust wor table 


4qPet Jump vector 


‚output coammäard 
‚name 

“Output tne 
fader oe eraorS now 


MOV axr offset rev tabl 1 


Lice Delos 
np. vev.2 


mov Gx,ortset rey tadl z 


int ddos 

mov el,baos I1 
Int 5d0s 

call restor 
ret 


„wait on user to 
‚read it 
‚restcre registers 


S I E IE E IE IE IE E AE IE OK BK A RE REE BK IK KE IE IE ENE IE IE IE E IE IK AE BR IE AK OIE OS OK OS OK OK BS AE AE ROKK OK OK OK BS OE AE OK OE 


‚Subroutine: 


Spas Loc 


‚Entry conditions: none 
Ber conditions: sper contains value for location 


, 


of spare sector 


sRegisters altered: none 


sSubroutines called: 
“Description: 
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Edwcurestorocon Iin„aserdee,.dee tin 





H UIT TEE T the location of the spare 
EL OM TES vadbNdoranEePers 2 to 250. A Bumter outside 
sof this range results in ar error message and arnotrer 
m_monpo. she valid number is converted to binary ana 
¡stored in the byte variable “spar”. 

) 


apar loc: 
call save ;Save all registers 
Spar loc 1: mov Cl,0dos_9 ‚output prompt 
pov dx,ofiset msg ? 
int bdos 
calli Con ain ¡get response 
call asc dec yconverr Lt 
cCallldec orn 
emp 27,298 ıck for Tanee 
joe spar orc z 
mov ci Ddos 9 ‚output error msg 
mov dx,otfset err_2 
int baos 
jmp spar toc 1 „start over 
Spar loc 2: mov Spar,dl "ore: nar? 
callonestor Peesuoreoeceris ters 
rer 


J FERAE IR A IE IE IK A EIE IE IEE IR IE IE I IE IE IR IR IE AE EIE IR IE IR IE IR IR IR FE FE FE IE IE FR IR IE FR FE IE FE IX IR IK FR D FR REIR OMNE 
momeroutine: trk_num 

sEntry conditions: none 

Et conditions: dx contains a track number 

Mugeisters altered: dx 

EN CUrInes called: save,restor,con in,asc dec,dec tin 
‚Description; 

H Poe USChm se peemptec tor da track number.  Tne 
valid range is 2 to 579. Invalid input results in an 
meomnor nessaze@ and another prompt. Tne valid number 
ese converted to binary and returned in dx. 

) 


trx_nun: 
E AS ¡save all regss 
trx_num_1: mov e lodos 9 ‚output prompt 
MOV 1, 021Set mse 4 
Pet Ddos 
eal con La joey Lesconse 
Cali asg dec convert it 
A 
cmp 11,579 ‚ck for ranee 
Srestrzenum 2 
mov cl,9dos 9 pgoutput errcr rss 
mes dr ,oriset.err 2 
int Ddos 
Jno tre Tum l (start over 
trk num 2: mov temp tX,dx ¡Save trx number 
earızrestor mestore tnezre>s 


SE 





mov dx,temp t& prestore dx 

ret 
RE NCI A OK AR BK A A MID AI ICE IA II A IA SI A II MEA IK BK OK FS BE OK AK HE IK C 
‚Subroutine: skw_num 
menotry conditions: none 
¡Exit conditions: “skw_fac” contains sector skew 
H tractor 
;Registers altered: none 
memproutines called: save,restor,con_in,asc_dec,dec_bin 
‚Description: 
, Tuezuserzsiscnrompred-tor d sector s«ew factor. 
;Tne valid range is 9 to 25. A number outside cf tnis 
‚range results in an error messaze and anotner prompt. 
EN varia number is converted to binary and stored in 
;the byte variable “skw fac’. 
, 


skw num: 
call save ¡Save all regs 
skw num 1: Mov ci, 0a0s5 9 ‚output prorpt 
Mov ax,ortsertr mse_3 
int ddos 
call con in ‚gay response 
Cal sdsic Cec PCONVeR Cit 
Cai leaeeeoin 
omped roe) ;CK for ranee 
joe skw num Z 
mov cl,bdos 9 "output error nse 
MOVediz,OLiset err 2 
int bdos 
jmp sSzw num 1 ‚start over 
skw num 2: mov skw tac,dl Tore Ina SKW rac" 
call restor ¡restore tne regs 
Bet 


g TEREI AEREA REFE RE KERE IK IE IK NE NE AE IE KE AR IK IK AK BH OE IK AR RE KE IE IK KE EI E AE E ITA IA AR XR XS XE 
¡Subroutine: loe _secg£_num 
mentery conditions: none 
¡Exit conditions: “log secu” contains address or logical 
, sector Y 
¡Pegisters altered: none 
meroroutines called: save,restor,con_irn,ase_¿ec,dec_tin 
‚Description: 
y MIES CS prompted to Input the physical address 
‚of logical sector Y. Tnis number can be in tne range Y to 
‚25. The input is cnecked and an error message results if 
MiS invalid, The user is also prompted again in this 
‚event. The valid number is converted to binary and stored 
jin the byte variable “log sec’ 
, 
log_sec@_num: 

call save ‚save all regs 
imoeeseco num 1: mov cl,bdos 9 ‚output prompt 


js 








MOVeadx,OrTSet moe 2 


int bdos 
Ca cones Toe es pols > 
Cama asc dec POORVE TL it 
call dec bin 
cmp dx,23 ;ck for range 
yee Tee sec? num_c 
Movcl,0dos 9 „oürpur. error msg 
Movedx,oriser err 2 
nr 20205 
jmp 108 sec2 num 1 
leg seco num 2: mov log sec2,d1 ist in loz seco” 
call restor ¡restore regs 
Bert 


SEE AE OS AK HE AE NE IE IE IE HS AK RE AR AS BR ASH AS AR AR AS E EA A ENS ARA IA AE A AA AA EE A AE SA RE RE RE R AS AE BE RA OE SA 
Eubroutine: head num 

¡Entry conditions: none 

;Exit conditions: “nead” contains nead number 

¡Registers Altered: none 

Mo tines caliec: con in, asc dec, dec tin, save, restor 
‚Description: 

;The user is prompted tc input a head number in tne range 
Es to 4. The input is enecked „ir an invalid number is 
sentered, an error message is output and the user is again 
Mam» red for an entry. Tne valid number 1s converted to 
;binary and stored in tne byte variable head’. 


Desd num: 
call save ¡Save all regs 
Bexd num i: mov 2104959 ‚output prompt 
mov dax,ortset mse 1 
int odos 
Sal eon sin ‚zet response 
cali ase soec sconvert to décinal 
calil gec Din FeCOUVETU to binary 
cmp dx,e£24h OTe CK fOr Tange 
joe nead num 2 
moy <cl,04¢05_9 sOUTDUT error mse 
ovd Orrse, err 2 
int odos 
Jro nerd num 1 sand Start cver 
Bead num 2: mov nead,dl ¡store in ‘neac’ 
call restor ;restore registers 
ret 


Qj RR IK AE FE FE AE AE EK HEA FE A I E N HE A EH AE A A IK EE I FE I FE FE IE IE FR IK IK IR SR FE IR HK OK SOK AE KK EH 
mouoroutine: con in 
¡Entry conditions: none 
Eur conditions: dx contains most sisnificant ASCII 
digits entered 
Brecontdins least significant ASCII 
digits entered 
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»Registers altered: dz,bz 

¡Subroutines called: save,restor 

‚Deescription: 

H EIO is utilized to input 
meine of edited data from tie console. Backspacing 
mes permitted through the use of Control-E or Control-i. 
¡Only a maximum of 3 characters can be entered. To 
salter this, the value of “buffer” must be cnanged. For 
sa complete description of BDOS function 14, see pare 29 
sin "CP/M-86 Operating System Systen Guiae ty Digital 
mees@arch. Two error conditions are reported: (1) if 
¿no data has been entered and (2) if the data entered 
sis non-numerical. In @acn case tre user is prompted 
‚tor data again. 

, 


mon in: 
call save a regs 

con 1n_1: mov cl,bdos_1% bass. console in 
mov dx oLrser ourfer input buffer 
mov buffer,3 may IH 
int odos 
cmp num_cnars,d Ce fOr RO Chars 
Jne con 115 

Bop in Z mov cl idos 9 sesmeole output 
Beonzsizscttse, err in 10220! err mse 
tpt tios 
Jopscon-in 1 

Boa in 3: Moved. num chars „eneck each coar 
Torme Set asc Cata lsentered for 

con in 4: mov al, [o3] ¡valid asc number 
emp al, 
JB ee 
cmp al,°9 
MO az 
imc 0x Fae co eG eer 
ac) tect fOr last num 
Jz con _ íin 3 
IInp con 13_4 

aon in_5: mov dx,® araiz result 
mov be,’ 
Cup Num chars ,1 omer or-. 1 char 


ane coneln 6 
mov bl,asc data _1 
jmp con in. 
Gor in 5: emp num chars ,2 POR ot Or ec ecnars 
per consi 7 
mov Dhydsc data } 
mov bl,asc data 2 
np Corin 8 
con in_7: Mev di,ase data Tl ¡must be £ chars 
mov on asc Zata 2 
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mov bl,asc_data_ö 

Eon in ?: mov ms data,dx NEEDS 
mMovels data, ox 
COM Ic rPestor 


Movedx, mS cata ¡place in ax 
mov dx,ls_data sand bx 
ret 


S RE AA IR FEIE IR IK IR IE EIE IE AK KE FE DE IE ARIE 28 BK IR KE DE FEIE KE IE OK ORCA AR AR SR ARIK OK ARIK FRG SIS FR OK AK FAAS TE ASAT ASAT ASAT AK 


E ubroutine: asc dec 
EN 0condivrtons:dx contains ASCLI representatior of most 
Stemlticant < digits of 4 e@igzgit rumbper 
be econtaias ASCII representation of least 
significant 2 digits of 4 digit number 
emir CONAitions: dx contains 4 digit BCD equivalent or 1x 
and DbY 
Reeisters altered: dx 
Eubroutines called: rone 
Description: 
Upoamentr ryto tnis Subroutine dx ard br must 
Neontain tane ASCII representation of a A digit number. 
¡Even if tne digit to be converted is not 4 digits, tnese 
jregisters are converted and therefore the number must be 
Meat justified with zero fill. 


“@®e we We we we We We we WO 


> 


asc dec: 
pusn ax ¿save resisters 
push cx 
push op 
pusn si 
mov si,24Efn sinitialize mask 
mov bp,01n sinitialize Do 
Bere Cec 1: mov add ¡een Det Caer 
and ax,si 
mov cl,al ‚save result 
mov al ak et Secora cnar 
and ax,si 
mov ch,al ‚save result 
mov ax. e ‚clear ax 
mov 3 cl 
mov cl,4 
Sina. von cT ‚ssnitt 
ada ral ca ‚result in al 
mov 1x,ax place in dx 
ompebp. PUn yomeck tor end 
ye Oye wees 
mov di,dx most sieni: In di 
mov bp,öön 
MOV eax , Dx jacj least signif 
Impreascgies 1 
mee dec 2: mov cl,08h 


Se led? cl 
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add 
pop 
pop 
pop 
pop 
Dem 


Grad i 
si 
DP 
EX 
ax 


a SO 
‚restore regs 


$B BRI IR IE IR IR AR EI AR FE OK IE AK OK IK AK RE A A II A A NC MI 3E FE IE FR IR FE IE IRE IR F 


¿subroutinesdec_bin 
matry conditions: 


snegisters Altered: 


soubroutines called: 


mocscriptions 


we ~we 


ax 
merit conditions: dx 


— Contains 


dx 


Saeveyresvor 


EU places the result in dr. 


, 
dec bin: 


Catt 


mov 
mov 
mov 
mov 
mec bin 1: mov 
mov 
Shr 
mov 
and 
mec tin 2: mov 
mul 
mov 
dec 
jnz 
add 
sub 


mov 
sub 
dn 
mov 
and 
add 
mov 


save 
AUX 
Sine 
bp,2300n 
cu Uc 
ZMED 
conan 
Ac 

Ox 0x 
ORR AACN 
ax. van 
bx 

Dita % 
CD 
L 
E DI 
bp,£1dßn 


UO 

CL Laan 
decToin_ 1 
Arc 
dx,¢¢¢tn 
Six 

Dim _num,si 


Call res tor 


mov 
ret 


ao num 


— Contains 4 digit BCD number 
Dinary eouüulvalsri 


This subroutine converts tne birary codec decimal 
(BCD) number found in dx into its binary equivalent 


‚save all regs 
‚save a copy 

sinit result 
‚power of 10 

IRL snitr taS toT 
‚move power of 12 
sto cn 

‚shift ECD number 
move it tc Br 
;mask orf the byte 
symudvciply factor 


‚move result to dx 
„dee nowen 5: 10 


paga "vo result 
‚sadjust power of 14 
‚tor ESxt Loop 
¿”TESTO TE number 
sad USt SEITtt count 


¡restore numter 
¿mask orf last byte 
ekrnalsresiuLlt 
asu bin nun” 


‚move result to dx 


9 FA RETE RE KEIR REAR AE IERE IK RE R IR AE NE RR E NEE E RE E RAR RR ARAS RRA AA AR RARA OEE 


‚Subroutine: bin dec 
dax contains Binary number in renee L-999 


Mary conditions: 


wart conditions: dx contains 


sRegisters alterea: 


dx 


digit BCD equivaient 





Subroutines called: save,restor 
— tns 
The binary number found in register dx upon 
¡enter POmtnlceuomwmene 1s Converted to its binary coced 
decimal equivalent. Note tnat no checks are made on the 
ES ug of the numoer but that any number outside of the 
Eines 0—999 decimal will produce unpredictable results. 


; 
bin dec: 


mea dec ji: 


Pea dec 2: 


N 
ee 


Dan dec. 


be dec 4: 


cy 


Bin dec 


Pin dec D 


Call save 

Ino vd te con 

mov bx,offset 
mov bp,?1Rh 
Doycanscts.7hn 
mov ans ms,2n 
pov cl Ln 

and dx,bp 

emp 42,02 

jn2 oij dec 3 
Paced | 

emp Cl,0an 

Jz oic © 
snl "op, 

mov dx,di 

mo tia desc 1 
gion al, cL 
Xlat tabiel 
add al,ans_is 
daa 

mov 315 15,31 
Ow cinedec. 5 
Mov Dr ,OfrseT 
mov al,cl 
meat table 2 
Aaa as 715 
dug 

mov ans ms,al 
Mov Oyo eet 
Iro biade 2 
mov al,ans ms 
add alia 
daa 

MOV ansıms,al 
jmp Din dec 4 
mov ax,@ 

MOV al,ans_ ms 
mov cl,8 
SUS. Cl 

mov cx,e 

mov cl,ansols 
gg cT 


table 1 


babes 


papier 
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‚save all resisters 
¡save tne number 
¡translate table 
sinitialize mask 
sinitialize result 


pant tbl position 
A DTE T 


supdate the result 
supdate position 
‚test last creck 


Update THe mack 
‚restcre rumoer 


TOocrsSet, Urdns. tel 
‚translate nunder 
pupodUu5s Une result 
;adjust resuit BCD 
‚store result 


»poipt To tatle 2 
‚translate nunber 
saa just to ECD 
‚store result 
¡restore EX 

S Go ms Cy TS 
pac just resuly 


¡store result 


stizali za result 
¿L Load Shit, count 





Mey iec num, ar „saverresu.rt 


pides UTD ‚restor rTezisters 
mov dx,dec_num ¡move result to ix 
Bert 


NEAR RER IRAE A DA E REE NAN NN ME NR N AE E FR XE 


BuUbrouvine: dec asc 

Barry conditions: dx contains 4 dieit £CP numter 

NE condítions: dx contains most significant 2 dizits 
in ASCII code 

OX mcomuarms sledast signiticant 2 dicits 

in ASCII code 

Reeisters altered: dx,bx 

Subroutines called: none 

EEScription: 


"9 "9 20 24 WO we we 


The 4 dizit ECD number found in dx upon 
sentry is converted to its ASCII eyuivalent ana placed 
sin ox and bx. No check is made on tne validity ot the 
Nata in dx. 


, 
dec asc! 


pusn ax "Save Tes iSTters 

pusn cx 

push di 

pusn tp 

mov bp,01n prmhrral:70 rlas 

mov al,dl sal low ny301l2 

MON pue d] SDI NIEN nvbble 
@ec asc 1: andesa Loon 

and b1,Cfh 

add al,32n ‚convert to ASCII 

mov cl,“ 

sr Ol cs 

ado DI. Sch ‚convert. to ASCII 

Mov. Ci, ad 

mov on.bi move result to cx 

cnp Dp, ooh ilast conversion? 


Jemec ase 2 
mov 0p, cer 
mov di.cr poowEsnesulteto di 
mov al,dn 
mov Of,anh 
Ute deerase 1 
meee asc c: mov @X,CX 
mov bx,di 
pop op PeestOre Feels ters 
pop G2 
DoD cx 
pop ax 
pet 
9 AE AR AE FE 9 IE HI HR HE AE A HS OR A EK A A FE AG HE IK AK AE AT HR AS AE AS ASAE RE KS KE SE SA IE RE AS RE BE RR RE RE E AE AE RE DIS SE AE AR SA RE RE R SE 


ssubroutine: save 





entry Conditions: none 
MrmescOhaitions. all-reeisters are pushed on the Stack 
sRegisters altered: none 
soubroutines called: none 
Description: 

Morse subroutine nusnes all of the registers on tne 
stack. Note that the call return is preserved. 


N we we we 


ave: 
mov temp ax,ax ¡save ax 
pop ax ¿pop return address 
mov temp stacx,arx ssayezcalereryrn 
mov ax,temp_ax ¡restore ax 
push ds puso Teeis ters 
pusn es 
push ss 
pusn op 
pusn si 
pusaci 
pusn ax 
pusn tx 
pusn cx 
push 4x 
Mov ax temp stack restore call return 
pusn ax 
ret 
g EIR IR FR AK AR AR KAR BAK AE AK I FR IE IE IR RE IE RE IE SE E XE IR IR IR IK E HE FE IE XR AE IR IR IR KR IR IR IROK SE KE KERE ER REIR CR SE 
moubroUtine: restor 
sEntry conditions: Stack contains all the reeisters 
wert conditions: reeisters are restored to tne condition 
merior to the cali to “save” 
ED !"sters aitered: ai! excepi cs 
soubroutines called: none 
A cription: 
; nass eubronmtinrerrewurns all registers to their 
¿same condition prior to tne call tc “Save”. 
9 
mestor: 
pop ax spop return address 
mov temp stacK,aX ‚Save the call return 
pop ax pop. auı secrsrere 
POD (Cz 
EO pmo x 
pop ax 
pop di 
pop si 
pop 5p 
pop ss 
pop es 
pop as 
mov temp lex,ax ‚save ax 


qo 





DO Mens ace restore call return 


pusn ax 
mov ax,temp ax restore az 
rer 


DATA SECTION 


we We we We we 


bin num dw 2 Musca so vercee DIr 
memp aX dw e yusedaby save end 
ump stack dw 0 ‚restor 

temp tk dw eon juseq by Crk num 


RR IRAE AE AR AE OR AE RK ORAS I I OK RE OK OE EAE I AE BK AK OK IRS FR BE IK TE DE DE FK KE XE KC IR BA HS OK OK AEE AEA IK BE A A 2 F 


, STORAGE PEOUIPED BY BIN DEC 

, 

7 

table 1 ab Cia 
db Gan 
db ¢4n 
ae Zen 
dt 16h 
do 32n 
aE Ban 
ad zen 
de seh 
ac Ten 

bable_2 db Zen 
db ven 
db Ben 
db gen 
ab gon 
dip Cen 
To ven 
dt n 
ap Ben 
do gon 

sod ME a ¿0n 

Bns 1s db Zon 

dec_nun dw gen 


STORAGE REQUIRED BY CON_IN 


? 


eo We we 


BUS fer db den 
num_chars ab Yen 
EScodara 1 db vön 
eeldata Z elie “on 
EascEdata 3 db CGD 
ms_data dw den 
Sida ta dw gon 


128 





j 
y STORAGE REQUIRED BY REV 
1 
; 


cmd name 4 db Ainitialize tis Disk s” 
cmd name 1 ab Mente Iritialization $” 
cmd_name_2 db “Initialize and Verify $’ 
cm2_name_3 ib “Format the Disk $” 
cmd_name_4 ab “Verity tne Format $” 
3 
rev tabl db wip,cr,1f,'Command to be executed: 
db io stb 
1 
rTev tabl 2 db "Paysical address of logical" 
db ” sector Ø: 
Hsc log sec db von 
ENcerlog sec’ 1 db Dn 
Nm loe sect 2 db zen 
db gr. Sector Skew factor: ' 
) 
mee SKkw fac db cen 
asc skw fac 1 dt oon 
Hoceskw fac z db ven 
dt era, tocetion of Spare sector: 
, 
asc_spar db 20^ 
ao Spar_i db een 
BE spar 2 ao Zen 
rev_taol 2 db anto Disk head number: 
asc_head db egn 
asc_nead 1 db cen 
Hsc nead Z db ¿da 
db ern. Becianing track number: 
asc Deg trk db Con 
asc_bee tre 1 abd 24n 
mecepee trk 2 db een 
db cSt Endina trace number: 
mec end tre db Ben 
Asc end _trx_1l db ¥en 
Beceend trk 2 db 20n 
db Cnt, 1 
ab ise SSater> to continue” 
db 


STORAGE REQUIRED BY PROC ERR 


me 99 9 


BET code db vun 


Broc err_taol ab wip,cr,lf, Statistics on Command 
sis Abortion: 
dd cr,it, “Command being executed: sS’ 


lem 





proc rr taol_1 db Chait Disk head number: 


mec dk head ab ven 
asc_dk_head_1 art gön 
EScEdk-head 2 db eon 
db cr,lf, Last trk number processed: ^ 
asc_trk db vn 
Sc trk 21 10 ven 
Esc trx 2 dt cen 
db er,if, Last sec number processed: “ 
HSc Sec db eon 
moc-sec 1 db een 
asc_sec_2 db 20 9 
db Cres, Error code: ' 
mee err c ib von 
ass err_c_1 db CDD 
mec, eTr_c_2 ab cen 
db TP ode gabig 
db "Strike <enter> to continue’ 
do oe 


JUMP TABLES 


-<e 


"-9 we woe 


Pop taol 1 dw in ver_dsk 
dw Ln Ver 45" 
dw in ver ds« 
dw fm ver aSK 
dw Im ver sk 
dw qescr 
dw Sene 

pope tacl 2 dw read 0 
dw read i 
dw Done 
dw read s 
dw read 4 
aw pog dm 
dw read 9 

jm», tab1 > dw rev ent 
iw cag ent 
dw ezemmd 
iw main 
dw S end 

Jmp tabl d dw cmi_name_2 
dw cmd_nane_1 
dw cma name < 
dw cmi names 
dw cmd name 4 

mp tab) 5 dw cag y 
dw cpa E 
dw cre 93 
aw cue Le 
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dw cna II 


dw cng 12 
Emp tabl D dw che 18 
dw enzoii 
dw (eels ar 


DESCRIPTION OF COMMANDS 


HY we wo we we 


ead ¢ 1b pen Loitiqiize tne Disk: 
db Erler, Tnis command is used ^ 
db ^to write tne address and ” 
ib “data fields on the disk.” 
dt Cree ft should only te usea if” 
do ^ a disk fault is suspected’ 
db rat, |! 
db Strike Center» to cortinues” 
read 1 ib wips er li, Verity Initialization: 
db cr "hyeocommand is used in 
ib "conjunction with tnae Iritialize 
db command. Cr, f, “Any errors tnat 7 
db “are discovered’ 
db "during verification 
dt “are reported at tne console. 
db Ce. LE 
db “Tne error codes can be Found in ” 
db “tne Micropolis Tecnnical Manual ^ 
dt np 24—25 - 
db cr, it Ef 
ib ‚strike <enter> to continues” 
mead 2 dt Cr,1f, “Initialize ana 
15 ‘Verify simultaneously:',cr,lf 
db “Tnis is a combinatior of the 
ib “previous two commands.” 
db CL E 
db "strike Senzer> tossortirüues' 
read _? db Winer ifqerormat tne Lise; 
ao Cnr 
db The cootroller «ill place Sin in 
dt aa telas cer LE, curing 
ib Piattializatcion of the diss.” 
db cr, It 
ab “Tnis commana is used to replace 
do Sle wiin ESA as this is p LT 
db Comat e/ Mex pecrts to find to” 
dd “create a directory 
db ere, lily 
db "strike <enter> to Continues 
read_4 db Winery. Verity une Format: ~ 
dd St 
db 2 Verifies that E5n is in the 
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do “aata tields of tne disk.’ 


dub LE 

do “strike <enter> to continues” 
read 5 dd oa it mead a Description ofr 

dd “these commands:’,cr,ir,lr 

db 6 A quick look at tne commands 

ab “available in "tae Micropclis 

AB Crile ““elttenarce äreı, cr,lt,lr 

db “strike <enter> to continues’ 
read_6 ib viore esii, End tnis session:' 

que CT IT 

db “ Immediately terminates tne 

dt “session with no further action.” 

dt orm pr bt 

ib Tre enter» to Continues 
ee e ee om es 
S MENUS 
H 
H 
menu_l au era Select Ontiorn:’ 

4b cnp M a Tayrlalıze the disk” 

dt cnc m Verity Inithealicacton 7 

db Greif. (2) [nivialize and Verify 

db “simultaneously” 

db sr \3) Format tne aisk" 

ib aria. (4) Verity tae format 

db ena. (o Read a description of 

db “tnese commands 

db cr.lf.'(6) End this session’ 

db cns saree selection ==> $” 
menu 2 db ett, calect 9orion: 

db O) Revie entrys © 

at er chanse an entry 

10 er,it, (2) xecute cormand ” 

db OP It. S) Start over 

dh a ases sion 

db cr.1*,1f, Enter selection ==> 5° 
menu 3 db Crait. selec, vaiue to chance: “ 

dt cole e Physical ajarass or 

db “Worical sector 2 

db cias ec tos sem factor 

at orif, (2) Location of spare 

db Gertie (ojeUlsk ges? number’ 

db er,i:, (a) Beeinnine track rumper” 

dt CUM oe adi trace number” 

ab on E Enter selection ==> S” 
menu_4 db S select value to cnange : 

db cr,lf, (2) Disk neac rumoer’ 

à er.1£,*(1) Pecirnine track number ” 

db @r,lt, (2) Siding track number” 

db ete nter selertjon ==> 5° 





micrst_err 


err_in 


msg 3 


msg 4 
mse 95 


ms3_5 
mse " 


ME u— — — qa AD QUUD qua a awe om om A ow A A A ee O A ee A oe ANE AXES GRE Gua uem Gu deme e e y E © GRE we oe ee e e e L Á e GEM GEM AMD cum ums 


ERROR MESSAGES 


db 
ab 
db 
db 
db 
au 
db 


GENERAL 


ab 
2b 
do 
db 
gen 
dt 
ab 
db 
at 
ab 
db 
db 
a? 
ab 
ab 
ac 
db 
ab 
oie 
db 
dt 
EB 
dt 
dub 
db 
1b 
db 
dt 
do 
ab 


nr cc Myeropold)s Disk Reset Errors” 
eno econ input.” 

“Only integer data iS valid. 

oaee Tra agal ==> 5 
wip,be,cr,lt, You nave not 
“selected a valid option. $” 
MD De, Cr,1f, SRROR: $” 


r 


A E cams dme 0m 


MESSAGES 


cr,lf, Session nas teer 
“terminated.s” 

A = 2 == ee 
ee ee c e E i 
ert USemot This program will 
destroy the contents of aisg 1111 
crl ts Do you wisn to ~” 

"contanue “(y/n)? $~ 

Cre Init disk nead number.” 
Col. Valid ranpe is ¢ to 4 ==> $ 
cri lapur toe physical 

“Ag@dress, on logical sector £.' 


` 


ea Valid rane E to 20 ==> $” 
co Inout Sector sew factor” 
coi Valid eaae ME to 23 == S” 
ersit, Valid razze J to 579 ==> $” 


ot, Input beginning 
trk number,S 
Gl. IDE end ne track “number. Ss © 
er,kt, opur location or ' 
“spare sector” 
cul, Valid oranes U 10 255 ==> 5 
coi Currently formattlre” 
ano or verifying forrat of disk” 
a please stand... 
era): Surrencly initializing 
and/or weriryine disk 
A Peo e “Stand Vis. sass 
cr,if, Command was successfully” 
ayscuted.S 


r 


e 


—— — — P A— <i> — A ae ap am © ARD E E E E a A AED E E ee TU O a duum GEED GEED A dun ow dumm cum GEH cms D aD px mr m r ow r p m r fr m cm eee CAD a, 


MICROPCLIS PARAMETER TAZLE 


db 
db 
Qu 
db 


db 


sen 
1 
cen 
von 
Cen 
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parms db en 


parms db Ton 
go_byte at Ben 
I-=2--------------- ------- -- --------------- ---- ------------- 
’ STORAGE REQUIRED 3Y MAIN PROGRAM 
? 
cmd type do Zen 
log secée dt von 
Skw fac qub KVD 
Spar ab vn 
nead ao eon 
beg trk num aw Ben 
= trk num dw ken 
end 
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¡Prog Name 
‚Date 
‚written by 


‚Modified by 


‚For 
‚Advisor 
¡Purpose 


we we "90 we we 


M 


APPENDIX C 


PROGRAM LISTING OF CPMBIOS.A86 


CP"BIOS.A86 (Master CPM Hios) 

SMALL IES 

Digital Researcn 

Man DL Perry 

Tnesis (AEGIS Moceling Grcup) 

Proressor Cotton 

This pios is tor use witn tae iSEBS6/12A. 
Inciudes login and borout routines and all 
Read/Write operation condvcted via common 


memory. Igt also includes the code for 
goa Talle lote? for the zemer floppy 
disk. 


IE IR IR IE IR IE IRIK XE IR IE IR IR BR IR IR IK IR XR IR FK IE FR FE FR IR KR IE IR IR KE FR FE FE FR IR IR AE OES HE EE ASS AE AE OR IR AS TK AS IK OK OK OK OK SOK 


EQUATES 


R AR AR FRIR IR IE HEOR KOR IR AE IR HE XE IEOR IR IE IE KE IE AS HE SR IR IR AS AE IA IE KR PE R SE IA HE FE RE RR SEIR IE AS KE SR TARA o AE AAA A A 


true equ =) 
false equ not true 
Er equ £dh San? ace Teror 
Lf eyu dan ‚line teea 
error equ örfrrn general error indication 
master er true ‚tor master/siave version 
loader bios equ false ¡set for loader version 
cmems22 equ CettUn ;common memory segmert 
„system addresses 
los int equ 224 sre erred EDOS interrupt 
, 
H 

IE not loader_bios 
, ————— O O O A O as O E E SE a CED rt t et mt em mt ei m O A G e SU a E E e a on ews oe oe a ew wn UD e o aa 
, 
ep oftser equ ¢€¢@¢n Start of CCP code 
bdos offset equ OEU6n »pDOoocenUtrycpotnt 
mos offset equ 25842 ‚start 0 5205 ‘code 





; 

Bros offset 
EOD offset 
bdos offset 


equ 1240n 
equ 0323n 
sau £4£06h 


console via the 18251 USART 


cstat equ ¢iah 
sedata equ vVa3n 
tbemsk equ 1 
rdamsk equ 2 

cseg 

org ccpotfset 
Sep: 

org bios offset 


start ot 140105 
¡base of CPMLOADER 
‚strippea EDOS ertry 


‚loader_bios 


‚svatus port 

„data port 

;transmit ouffer empty 
¡receive data available 


G FEDE IE IE IR KE AE RE XE NEIE SA AR A OR IS OE AE A BK OK A AS A E A KE FE I NE FE FE ARRE RAR AGE 


¡JUMP VECTORS 


S DA RE AK IE KE AE IE IE E IR IR IE IK IE IE IK AREA AE KE IE E FE KC IE IR IR SR IE AE KE E FE D IE IE IE IR FR FE FE IE IERE IRE FR IE SR FR RR FK 


bios: 


imp 
jmp 
jmp 
jap 
JTD 
Jmp 
jnp 
JNP 
J"p 
JTP 
inp 
JTP 
JTP 
INP 
Jap 
jp 
JUD 
jmp 
jnp 
JTD 
jmp 


e 
3 
. 
, 
. 
3 


INIT 
WBCOT 
CONST 
CONIN 
CONOUT 
DES Tout 
FUNCH 
READER 
ROME 
SELDSK 
SETTRK 
SETS 
SS LEME 
READ 
WRITE 
LISIST 
SECTRAN 
SETDMAB 
GETSEGT 
GETIOBF 
SOT Lor 


Per trom 30017 ROM or LOADSR 
sArrive bere from BDOS call ¢ 
;retura console keyboard status 
‚return console Xəyboard cnar 
‚write Char to Console device 
‚write cnaracter to list device 
¡write character to punch device 
¡return cnar from reacer device 
move LO trk 20 on sel arive 
„select alskstor nerrt rd/wrire 
‚set trace Fformert ri/write 
„set Sector for next ra/«write 
Set Ot Set for user durf (DMA) 
;T9ead a 128 byte sector 

¡write a 123 byte sector 
‚return List status 
sxlavresioescalespmoyeical sector 
¡set seg base for buff (DMA) 
sreturn orrset ot Mem Desc Table 
¡return I/O map byte (iotyte) 
‚set I/O map byte [(iobyte) 


IE IR XE FR IE IE IERE RE IEIR IR KE IE XE IR FK IK E FE KE IE IR IE XEXE IRIK IE IR IR AE IE ZE IE IE XE FR XR IEIR IE SR XERE IE XE IR XE IR XE IE FR IR IR XE XE F XR 


Entry Point routines 


HE RE FS IK IK TE LK AE HAE AS XE IK IK IK IE IR KEFR IE XE IR KE IR FR KESA IE IK RE IE IR SK IE XR IK XE IR FE XR FE IR IR XR XE IR IE N3 XE IK XE IR ENE OK EE 
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Iu not ioader bios 


EN DIF 


5 RE IEEE RA II E BRE ER A BR AE OR AK OR AK OE OR OK A EO OEE F 


INIT: sprint signon message and initialize nar4ware 
sand software 


DON C ’ar,es swe enterec witn a JMPF 
mov SS ,aXx ‚so use cs: as initial 
mov ds,ax ‚segment values 


MOV @S,aXx 
MOVe SD,c:fTSset stkoese suse Local stack 
cid clear alrection flags 


IF not Loader_bios 


e e ae e ae oe Am ee O A A A a oe A A e e e e <i> GEH dumm GE ee © Oe © ee we Oe oe oe © © A cuum O O A GuED oe © dumm sam ee we oe re Se oe oe ee e oe oe 


Riis seam TOS ror the CPM.SYS rile 


Setup oti mterrupe vectors 12 low 
memory to address trap 


ei .. 6 .. “0. 56 


pusn ds 

push es 

mov iobyte,0 clear i/o tyta 

MOY (an. SHG trac Froutire 


mov ds,ax 
MOVs ©5,2% 
Mowe to tottst, offset int trap 
no ite ese sre nt .cs 
mov di,4 »pDropesate 10 remainine 
svectors 
mov si, 
MOV ¢CxX,010 
pep move azx,ax 


mov  bdio,bdos offset nocormectebdos InvOvecotror 
pop es 
pop ds 
, 
; =. a ae an an ee ee cree oe ee om es ee ee ee sw ee ee ee ee oe ee ow es we wer e a a e e e m m e a e e e 
ENDIF punto goader bios 
ER loader_bios 


Tnis ís a BIOS for tne LOADER 


de Wt we We 
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push ds ‚save data segment 


nov ax, 
mov ds,ax ‚point to segment 47 
mov bdio,bdos_oftset MO ay Set 
Nov bdis, CS POCOS A MLerrupt sesment 
pop ds 

H 

, e e crn b v m mb tn min DG SE SD LO O E GS GD SG GD ED OS m ey ee ee e ee o E E E E e e e e D 
ENDIF ‚loader_bios 
Sell econ init runleelalyzezeorsole 
mor “Ox ,0x yee mass storage 

nil: 

move ar 1510) |6x] zrarpoaTlI2S3tlor tale 
or axe © FUEL end rat. table 
E L L 
ppush 5x 
c scalı 1n1p entry 
pop bx 
mec bx ‚step to next entry 
Inc For 
pop ana ‚loop for next 
DE not loader bios 

; un an ao ap ap ap am IT RA LE LL Pr: a O O e e e e o e e es e e e e o a e e O O a O a O A e e e e A GERD ias œs 

H 

HL 


ea TE Iosrin 

Mov |Ox,0rtSet Sienon sprint sien on mse 
call pmsg 

TOV ci user 


we we 


EN DIF AOL odder Dios 
[E loader bios 
, = m e m e O e O E we we we we we re we we we we we we we we we wm we we we wn we we we ee ee we me ee ae ee a a oe m D 
H 
e: 
mov UX,O1fSset signonl ‚print sign on message 
call pmsg 
mov cl,@ deraut to a on colfistart 


Moy Sind tg 


we we 


ENDIF ‚loader_bios 


NDP CED Iun to cold entry ot CCP 


gE RFK FE IK XE DEAE NE SAIK IE EE E FE RE E IK IE KE FEDE IE FK DE IE BR RE FE I I IE IE IEE ORS DR SEIE IR FE XE KE MEE OK ATE AR AS KE 





WROOT: senter CCP at commana level 


jmp cepts 


IEEE TE eater AN re ge ne eh oy O STARS Ringe of E EE IIA E IMA € EE AE NE A M HE AS AE 
CONST: ‚return Console status 


in al, cstat 

and al,rdamsk 

DET Gorn 

or al, ffn “retura non=zero 1t ria 
conl: ret 


y RR OR AS ARIK FEIE XE IRIE IE IE KE IE IE FE OR A A OK IK OK OR FR IE RE IE SEIE IR IE FE XE R IE IE IE IR FE KE IE IR KE DE IE FE HE B BE K AE AE AR ARA 
CONIN: ;£ot a character from console 


Gall CONST 


UE CONIN wait for RDA 

in al,cdata 

and cal, fn sedd data A renove parity 011 
De 


g I IERE IE IR IE HEIE AE SEIR IE IE FE IK AEIR KEI KE KE DA IE IE AA A A MOS AA MI IEA SI ER ORG O EAS AS AE E ARA 
CONOUT: ‚send a character to console 


bn al,cstat 


and sal, toens & A ba tus 
2 CONOUT 

Dow m cl 

out cdata,al Spir Ourf 15 empry 
Bet 


SPEARS IR IR IE IEIR RK IK FE FE IR FR IE KE KE IE IR RE KE SE IA IE SE IE KE FE IE IR ORR AS OE OK OS OR OK OR OE SR AR SK OK OR OK AS AS BS I OE AE OE OE OE 
fa 


EISTOUT: sena character to list devi 
‚norsyet. implemented 


y TARA AR AER E AI AIC A EE E E E FE ARR SS OS IK OE OS SK OR IR NE IR XE IE FE FE XE AE KE IR R DA XE 
PUNCH: pwr Ge Character to puncn device 
Meo t mp lemnen ted 


Let 


y FAMA E K R KA IR IE AE IRE NE IR IE IR IR IE IE IR FE IR FE IR IR FE IE IE FR IE AC XE SE E SE IE IE IR FE SR IEI OR AC AR OR A FS TR AR 
READER: ‚get cnaracter fron reader device 
photo implementedc 
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we "99 e 


S 


mov al,ian 


;return eof 


ret 
RE ASHE AE AK aye FS AS HE AAS AE AS IK AR SK AS HE AS IS SR AG AE AS AE AK AS AT AS AS 9G AS AS As AS 3S O48 AS BK SS AS AS IS HS AS AT AS HS 3S AT AT ASAE 3,5 AK AS AE AS AE 
OME: ;move selected disk to trk e£ 


mov track, 


mor C DIODX 
mov rrlsunit 


add DEI 
call hmtollbx] 
net 


HE IK IR IK IE IE IE IE IK IA IE IR FR IE AK OE AK IK IK IK AE SK OK OS IE IK IE IK SE IK OK OK IK OK OK IK OK Bk IK OK BE IK KE ASAT AS SSE AS SAS ASAE BS AT AS AK AS AE 


ELDSK: 


eturn pointer to appropriate “disk 
(zero for bad unit ro 


oTe 


prn 
¡parameter block’ ) 
;N nunits is defined in tne .cfe Tile 


Don Funitd,sl 
mov ox,8¢d¢n 
CMD ch, nunlts 
jnb sell 

move, DL,unit 
add 0x, 0% 
call asxtol[bx] 
YODM Doy 5X 

mov bI,UMIT 
nov. cl,4 

SRI jen, cl 


mov cx, Offset dpbase 


add DX CE 
sell: 
Tet 


‚save unit 
ready: tor 
return if 


) 


, 


number 
error sreturn 
beyond max unit 


16 


bx += àdpbase 


J IE FEIK IE IE IE IE IK FE IE IK FE IR IK IE XE XE FEIE IE IK KE IE ZE R FAE IK IK IK IK IE FE FE IE IE IE FR IE FEIE IE IR FE FE IA FR IR IK A RER IR KE FR IR FA FE SK XK 


SEITREK: 
mov vracrc.ot 
XOT OXOX 
NOV ou not 
add Dr. 5X 
Gale traecbl lox] 
ret 

e 

ERTS EC : 


Mov “sector, CL 


‚set tracx address 


‚set sector number 


1958 






xor 0% Om 

mov “OL, unit 
add bx.bx 

call sectollox] 
ret 


7 BR REDE IE IE IE AER BEIE IE IR IE IE FE KA IE IR IE EE A IK OK AK EE OK BE OK OR AK OE OK A OK AE OS OK OK IK FE FE IE IE AE DA FE FE AE A RA IE IE 


SETDMA: set DMA offset given oy cx 


mov dma_adr,cx 
rer 


; FR AE FE HE FE AS HE AK AR HE IK IK HK IK FR BK HE AK HS TK AK I IK HK TK IK AK IE Te AE IK AK IK IK IK FE HK IK IK IK HK AK IK IAS AT IK HE AK IK RAK Ss AK IK AK FS HK 
READ: mycccdmseleeted nll, track, Sector to ¿ma adar 
‚read and write operate oy an indirect call 
muDPourPHOotnecepproDriate tqble contaired in 
;the configuration file. It is tne programmer's 
¿responsibility to ensure trat the entry points 
mn these tables match tne unit type 


XOT 0X, 0x 
nov "DL, URI 
ada 0x, ox 
Sele rate ox | 
mo 


FR RAE AS AR AE AR AS SS BR AS AS HR AE HS FR SE AR SR R KERE BE AR DE SE RE RE AE AS SR AE IRE AAA A IIA AT AS AT AS AE AT AS R 
write from dma address to selected 
unit, treck, Sector 


xor 6%, 0% 

mov co) ,unit 
ada bx, 0% 
Call wrtol | ox } 


eee BRE AE HEAR A IR RE XE AR AE KE A RIADA AA AA AE MK AZE M RAS HEA AT AT AS OR FS 
ENSTST: spoli list device status 
woot implemented 


Or al, rrn ¿return ready anyway ocr 
ROT ‚system may nang up 


gj P IE RE IE FE IX IE IE IE FK IR FE IE IE IE IE KE IE IE BKK KE FE IE FE FE FR I IE FR IE IE IE FE AE FE IE SR FE IE IE IR FA FE HE IE KE IR E FR F FR FR IE IR XE E XR E 


SECTRAN: ¡translate sector cx by tavle at ldr] 
‚NOTE: this routine is not adequate tor 
roe wcdse Of >= 255 sectors per track 
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A setter than DR s which is not 
pacc ESPOPEATDe no table case eitner 


mov cn,@ 
mov Dx, CK 


cnp dx,® ¡Cacao ino table case 
je sel 
aad Dx, dex n3dg eec ctoreto table addr 
mov dl, (bx! ¡get logical sector 
sel: 
ret 
g TERESE NE SRIK KEKE IE SEAR HE AR AE OG IK HE AK NE IK AE AK AE HE ARE HERE AS AS EAE IS HE TE AE AE ASAT AEA MAE RAE ASAE AE AS TEAS FERNER EM 
SETDMAB : ;Set DMA segment given boy cx 


mov dma_seg,cx 
ret 


g FEIR RE SR IE KE IE IK IE IRIE IE IE IE IE KE IE OK OE AK IK RE IK BE IEIR IR AE FE IE F RE DE IE RE E FE SE E IR IR XE NE BRAK BR OK FR FR OS OK PK AE AK OR FR OE SE 
GETS E GT: ;return addr of physical memory table 


mov ex.otfset segtable 
ret 


SERAN IENE IR IRIK IR IE IK IE AE IK AE FE AK AS IK AK OK IEKE ESK IE IE XE IE IE SE IK IE IK IE FR IR RE IE IE IRIK IK K IE SE IK IR SEIE E IE AE SE IK N 
GETIOBF: ‚Teturn iobyte value 
motle tals rumction and SSTIOBF 
;are OK but to implement tne function 
atnescharast>n IO Gentry polar routines 
snust be modified to redirect IO 


&»depending on the value of iopnyte 


Move dhiobyte 
Bet 


2 RAK AK IK OK IK IK IK RIK AK AE OK IK IK IK IK OK IK IK IK IK SK IE IK IK IR IK IK IE KE IE IK IE KE AE IE FE DE IE RI OR HE AK OK HK AK OK OK OS IK OK OK KK IKK 
SuTIOBF: ‚set iobyte value 


move LObyte,cl 
pet 


HE BRAT AR AT AT AE AT AE AK AE AE AL AK SE FE IA IR IR DR XE SE IR KA AEE OS AE BK OS HE AE OS OE OS IK OS AK SH BS AK EE BES AS OE EAS EAS OS SE AE OK OS 


SUBROUTINES 


HE IK IK KE XE IE IE XE IK IK IR IK KE KE SR IK IK XE IE IE IR IR RE IR IRIK SP IR IE IE IE AE XE KE KE FK SE KE RE IR RE IRIE RERE IE OK OK AE OK RE OS OK AE OK OK OK 


é ê we we 





LE not loader_bios 


9 

Ent trap: piuterpupntetrap — nonvinterrupt 
‚ariven system so snould never get 
;nere — send mesage and nalt 


eld „Block Interrunts 
mov ax,cs 
mov ds,ax ;£et our data segment 


mov. -bx,offset int trp 
call pmse 


Alt snarastop 

, 

; — ——— un m Te aeae aeo g m oup Gun A ee oe ee oe ee ee ee ee i a ee O cb 
ENDIF ‚not Lodder bios 

con init: aa Sc O ns oe driver 


(actually scone by tre isSBCB6/12a monitor 


ret 
, —————————————————————————————————————————————————— 
pnse: ‚send a message to the console 
mov al, lox] ¡get next cnar from message 
test al,al 
M pmsi pif zero returr 
mowumcl.al 
Gall CONOUT sprint it 
ne 0x 
jmps vpmse 
pms1: 
ret 
H DISK INCLUDE FILES 
J E IE RE IE IK IK XE IE AI AE HE AK HE HK AK AE AK IK IK HK IK XE IEIR IE IR XE FE IE FE IE IE IK IR IE FE IR IEKE IE IK IE IK XK IE FR IK IE IR IE IE FR IR XE XK XK SK 


include rxrrlop.a&6 
include micnard.a&6 


IF not loader_bios 


include mbgBZdsk.a86 
Include rrnard.q86 





ENDIF inori loader olos 


292 


SA AEIR SE IR KE RAS AS AAA HE AE AC AK AS AE IE AT AE HAS OK ASST AT AE AS AS ASAE AS SEAS SS A IE IR SR NR RAM MR ARR EE MK MEE ARA A A 


; 
1 RESOURCE ALLOCATION 


EEE NS EN E SE DE AE E AE IE E FR HK IE IK IE KE E IR FE C NS AE RE HEAK AE KE IE IK FE E ATE E IE AE DA RE AE AG SE IE 


low-level synchronization of access to Lhe shsred 
den Cere yne. SS> MUST Include the cnree entry 
points definec in tre cfe.files. These are 
PE cOn a zen tonada Detore and after 
accessing tne resource respectively. 


w.e Wewe we we 


IF NO loader Dios 


ENDIF siot Loader bios 


BS ARAL HE IE AS BK IS A TRAE KE RE SAE NE XE AE SE IE RE AE IE AE DR IRRE RE IR RE AE RE NE IE SR IR SE IE AE AS YS OS OS A IR XE IR KOK AS I AE KOK OK OE ES OK OE 
DATA S LOCAL STACK AREA 


RS AT AE AE AE HE ASAE KE SEAE XR KE XR SR HS FS ATE YS AE I AS HS ARAE XE AE BE SR SR DE IE DE RE XE AE IE AÈ DE RE XE E REE ARSA IE DE E AS BA AR XE a RE NA SE GR 


we we we 


cseg $ 
signon qb Cr,lf,Cr,lf l) 
JD cialis li. 
if master 
db “CPM/26 Master 
endif 
1iMnot master 
db “PM SS Slave” 
endit 
Dn noroader Dios 
, -e ae an e e e E a O A A A O A A a EEE Ey A EEE 
; 
db Crist,” Modified 
db “22 April 1983 oy” 
db e i 
db Mars L. Perry” 
G.D GT 
db : For use with a Bubble Memory , ~ 
db “tne REMEX Dataware House,',cr,1* 
ab J and tne Micropolis Disk Drive’ 
db E 
t 
; =e e r dr ee ee > ee ee o cs cs e a co cs o TO ee es ee ne ee es es es as e cs «O A a s 
ENDIF inot loader bios 
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Ig loader bios 


signonl db et, CP/M-86 Loader’ 
ib CE. Version 1.£° 
db cr,lt,°Loading CP/M from tne Remex” 
db Moo Ds Dive... .€ 
H 
, an ao a ae ae o e e a e e e e e e p t o t v m p ee ee ce ee ee ee ee O e O ee we ee E e A m m — a A do — 
ENDIF ;loader tios 
moe trp cb Crs 
db SInterrupt Trap Halt 
db ODIT 
Bobyre rb 1 neagracter 2709 redirection bvte 
unit rbd d PSE ected urit 
frac k ro il pselected) track 
Sector rob l ‚selected sector 
ora adr rw l ¡selected EMA address 
dma see rw 2 ‚selected DMA segment 
loc stk TW 12€ peOcalestace for initialization 
Stkbase equ offset $ 


„systen memory sesment table 


segtable "5-1 ‚„l segment 
Gwe Cpe see ‚ist seg starts atter BIOS 
e FonmGmexTencs, FO Lop or TPA 


RE IE IR XE IK KE IE RE IR IE XE IR IE IR IR IR IR IR FE FE IR KE IR XE IR IR IR KE FE XE IR IE IR BEE OE OK OE OK BS EE AC IK BKK AS AE SK AE AE OE SOR OK SK 


; 
j DESKEDEVTCEHTABLES 
; 


a8 ASHE ALAS AR BE AEIR SE IR FE KA BE AT AS SS SS AS YS ARME ARR E ARM SREE N R EE REAR SAS EEES 


meee DCliuded .cfe file below maps unit number to disk 
ENS Uc9S type. it provides tables of entry point 
saddresses tor use by init, read and write. These 
EDUMCSses must appear in tne appropriate inciude 
IUS for tne particular device type 


Pue Lude commast.cfe ¡Decora cont renration 
‘tare 
TE loader bios 
; ——Ó——— ROÓ—Ó—————————————————————— m 
; 
nancluces lormast.cfz poede 1h Contieuration table 


-e 
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ENDIF ;loader bios 


ans included .1iíb file contains disk definition 
stables detailing disx characteristics for tne bcos 
;.lib files are generated by GENDEF from detrinition. 
Bees and must comply with the allocations made in 
meme corresponding configuration file. 


IF not loader Diós 
, me ae aw aw DO O EPA O AA O e O O UE > a es UD LU O O O SEO GEO SD ee oe A O O E E A E O O A oe es ee m m D D D D D D me me m m m ae 
) 
include cpmmast.lio Pena sk des tables 
H 
A e 22-22 2-22 = 
ENDIF inor loader bios 
IF loader_bios 
; nn axe ew ene Se OE im ED wD P ———————Ó—————————————————— 
H 
include ldrmast.lib „read in disk cder tables 
‚tor tne loader 
; 
, aw aw ane aw ane ow ane e Om eee aw Om Oe ew ae > ww ae om ae oe oe oe oe oe ee om oe O amp ame an amp e e TA ne e E e ow e me me CED GEO CEO CEO ai ame o 
ENDIF ,;loader_ bios 


PER IE I HG IE A EE AK E IK IK IE EE IE REE IK IR IR IK E E IE IK IK IE IK IE FK IK IE IR IE IK IK IR FK IE XE XE XL IK IK XE FEFE NE XE IK IX SK K 


; 
; ENDS OF BIOS 
H 


WR FE AE HE AK HE IK AK HE AK AK HK AK HE AK AK AK IK AK IK AE AK IK AK AK IK AK AK IK MEME E AE M HG AK IS IK AK NG IK SEAS OK SK IR K KE IR IK IK IK AE 


lastofr equ offset 9 
tpa seg eau (lastofr+8420n+15) / 16 
Mpa len equ Gee = bod sce 
ao O stiliolast adcr fer GENCMD 
, FR FE AK HE AK AK FE AE AE HK IK TK AK IK AK HK E SE IR FE IE IK IK IK IK IK IE IE IE IE IEIR IK I IL E R IR I SE E FE IR IR IR IE FR A A AR 
H PAGE ZERO TEMPLATE 
S FE FE KE RE IR SE SE SE SR DE XE NE IR IE KE SE RÈ AK AT HE AE Bk BE HEE BS AC A KS aS AK AE A AE R XE AS AE BE DE XE Dé BE SE DE SEIE RR 
dseg 2 sabsolute low memory 
org 2 ;(interrupt vectors) 
Prete orrst rw I 
more Seement rw l 
TW er Godiossint—1) 
odio TW 1 nbdos Interrunt otfset 
eais TW JL ‚oaos INTerrup, seement 


end 





le 
It'd 


PENDIA D 


PROGRAM LISTING OF CPMMAST.GFC 


:Proe Name CEMMAST.CFG Master Contiguration ror CPM) 


‚Date 298 Anr 1101985 
‚Modified by: Marz L. Perry 
¡For > Thesis (AEGIS Modeling Group) 
sAdvisor "UEPrOtessor Cotton 
¡Purpose SOLES acude file y/1rn CENETOS.ASO. 
H It contains the device tables for access to 
; tara Ton sredd, S write roeugines. It 
; also allows ror (hewdeyotopment ot a loader 
; BIOS, 
IF net loader tios 
ee ee ee oe a ee a emm 
; DEFINE nunits 


murits db 12 ;70tàl number of mass storaee units 


ry 
== 
tZ 
Hs 
he] 


nor Loader bios 


INTETALTZATIÓN TABLE 


"9 99 


Bel contains d sequence of addresses of initialization 
meotry points to te called by tne FIOS on entry after 
Mco la root. Tne sequence is terminated by e zero entry 


IF master and not loader_bios 


intol GWeCrE Set mbeAdsSk init j;initialize Bubtle 


Gweorrset Ext icp Init sinitialize Temer 
Gwe oti set initsynce yinitidiize syne variables 
CerOrmset Init login ee Los La 
Osea mie init Eo POS E 
dw Y Jena Cf table 

, ee a O p r an an an an ab am an am am am am cs ee we we we we we we ee we we we ee ew k e a A O A A E e O O es ew es — À! 
ENDIF master ar: not loeder 5:05 


Kreroremeastversandenot loader bios 
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ee eo eo «e TED ED E LA A ee = ee ee O LO ars Gu ee es ee ec ee ee es es es ee ee se ee ee ae e mm 


mnt bl qgweottset mibecisx init j;initialize Bubble 


awe Ort Sel Txt op sinit sinitialize Remex 
dw 2 ‚cnd of tatile 

, 

; “o du CEP GED GRD GRD GED GED GED GRP GRD GED GED CEP GED AND y R (UND uu CEP SED Ow A D AD OED oe ee UD GARD A A ADD GAP RAD uu e c c c a m s e e m du com m Giu (uum dam A um SD 
ENDIF nor mester and not 


;loader tios 
; READ TABLE 


meatvbl ana wrtbl are seguences of lengtn núunits, containing 
the addresses of tre read and write entry poirt routines 
maespectively which apply to tne unit number corresponcing 
¿to the position in the Sequence. These and the entry pts 
ED nITISHIZation must correspond to tmose containec ía 
Be sppropriate include files containing code specific 

mea, tne devices. 


Pe Rot loader bios 


Garol aw Offset Moss e read 
Cieoe aScol Ske lop read 
Gweorrset net lop read 
COS eL Exdard read 
Enasotfset’rznard read 
AMOS Iced read 
R SOE ard Teac 
dw orrtsot mie read 
Seon ase L mic reag 
Guort Set Mic read 
dw offset mic_read 
iO set nic. tread 


is a bubble remory 
is nemexr tlopoy disk 1 
is Remex floppy disk 2 
Hs Reme@x nara disk J 

is Remex rara disk 
iS kepez nard disk 
is Remex nara disk 
Se TOOLS 215% 
2S Mleropolls dls« 
1S Micrepolis QTI>sK 
Lo TSPODOILIS disk 
SE SOLO lAs LS: 


"€ we "9 999 9 9 99 99 We 999 9 99 
66 oo oo 9*9 ee oo 


TS GH Gà r4 9 CJ C2 t5 pa 


f Cd NA GS CA SNL (S 


ee oo e. oo ve 


=e e aD Ae SD ee OP ee A UD > Oe > > A A O PA e ee A e A A GNED A A O A Gus» ee GUED ee es es ee i ar z cmm 


; WRITE TABLE 


wrtol DMO n Seb moe das< write 
Gweortset rxflop write 
SuEOtiser rxrlopo write 
dw coftset rxnard write 
eve Ort set LxAHaTd write 
Anote tl nara Write 
SD TE “kenard write 
wmo e Mic rte 
GwWeottset mic write 
Ao Set Mic write 
au ortset mic write 
INOT SETIM Writ? 


146 





trktol 


dw 
dw 
dw 
dw 
aw 
dw 
dw 
dw 
dw 
dw 
dw 
dw 


dw 
dw 
dw 
dw 
qw 
dw 
aw 
dw 
dw 
dw 
dw 
dw 


dw 
dw 
dw 
dw 
dw 
dw 
dw 
dw 
dw 
dw 
dw 
dw 


OESO 
offset 
offset 
Is E 
offset 
offset 
offset 
offset 
ortset 
OMSET 
offset 
offset 


offset 
offset 

ffsert 
offset 
ofrset 
offset 
offset 
offset 
Of Set 
offset 
offset 
i seu 


offset 
offset 
Off SEL 
offset 
orrset 
Cease tl 
offset 
offset 
Ot Set 
offset 
offset 
offset 


HOME TABLE 


mbe¢dsk_ nome 
rxt Llop nome 
Err lop 2ome 
enara nome 
rTXhard home 
rxnard nome 
iesdet s efeto eter 
mic nome 
mic home 
mic nome 
mic nome 
mic home 


ER m e m e ee Gem Aem A A E E E O GEL Se oe ee ee ee ee ee es a ee MED A AO 09D CLR A A A ED CO wo 


SELDSK TABLE 


mbS?dsk seldsx 


rrrlopcseldsk 
pri lopEselugsk 
Krnarc selcsk 
Draaru selusk 
pxnarirseleek 
penado. setas a 
miec seris 
mic_seldsk 
mic sellsSz 
Geese. aoe 
mic selasx 


SETTRK TABL 


npsvdctcesertr 
5rtlop-settrk 
RXELOp settre 
pxharc settrk 
pnxpaerdosertrk 
Frliarüssertr£ 
Renate [Settrz 
nio sertrk 
mic Setir 
Mic settrr 
mic Settrk 
mic serttir 


nao: Guo O o A— om em € A Em GANE oe O E o E O E E E CO ae ae oe A P m a A A A a E a A O A A a T ee A Ow oe oe oe oe oe Se ee © e A A uum 


P 
a 


K 





sectbl dw 


offSet 


SETSEC TABLE 


mle od Skeseatses 


dw offset rxiilop setsec 
gweotrtset rxfi lop setsec 
AMOS et el dese hoes 
Gweoltseterkhard setsec 
EweOrrSeterxznard setsec 
dw offset rxhard setsec 
dw offset mio setsec 
AMO SS tino. Se sec 
A Le le 
duor Set Mie. setsec 
WO Set mic setsec 


EN DIF ‚not loader_dbics 


148 





APPENDIX E 


PROGRAM LISTING OF MICHARD. AGG 


¡Prog Name MICHARD.ABS (Micropolis Hard Disk) 


¡Date SETS ADTI 1923 

‚Written by : Marx L. Perry 

¡For : Tnesis (AEGIS Modeling Group) 
‚Advisor s Professor Cotton 


Tanis coae is an include rile w/in the 
BOS On aln S tue hardware dependent 
code ror the Micropolis Disk Drive 

IR IE IK AK AK AK HE AK AK HEHE AK IK HE AK HK IK IE IK HK NE HK IK HK AE IK BS SH IK IK IK AS AE AC HE TK OE IR FE IE IE FE OK IKK FS IK KAS IK OK SR AS AE AS OK HK OR 


EQUATES 


E AE AE RE NE IE AE AE IE IE E IK FE IK IE IE IE IK IK IK KE NE IK XE EAK AK K IR AK IK IK I FE KE IE OK IE FIE IR FE IE IR AE XE XE E IE SE SE IE IE XK FR IK R XE 


¡Purpose 


wewe We we we WE 


a. BOUAL ES DORA E TA == == == === 
, 

mee porte equ ¿cen ¿command port 

moe porta equ Gc8n sol—di rections l 

mie portb equ can »nourtsut port 

mre porte equ Ceen scontrol/stdatus 
mic_mode2_2 out squ GC D ¡mode ror 255 

, 

aa. oren UASD Beso PIT -=-=--==-==-------- 
, 

musmode port equ egin smoce for timer 
Ac CcounTt_port equ ¿vazn ¡counter port 

Me mode cati SM ces5on mode cörtrol value 
mec isb_value equ Jen least Sig valve 
mic_msö_value equ sen ‚rost sie value 

, 

EMEN —- 0USTES FOR TES @259R" PIC ---—--—----------- 
, 

mec icwl equ lön CONTO MAROTO 1 
ME 1cw 2 equ 40n peo Erol werd 2 
mic_icw4 equ ern ¿»control word 4 
me oCwl equ vefn 

oi portl equ cocan ;lcw port 

ZNCNDIC poru2 equ VUc2h ;072W port 


MICROPOLIS EQUATES 


t we we 


, 

fecerstr>_or equ £20€219120 ‚reaazsiznal 
EUpETStr5 ofr equ CKC CEG LC D ‚read Signal orf 
Teeewstro_on equ CIOIL D «rie sienal 
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nic wstrb off 
mic stat 

pic cmd 

fic deta 

mec strb on 
Ge stro off 
mic ack on 
mee ack off 
fee en sel 
mec Stndrd 
mee irdy nask 
mac ordy_ mask 
mac tusy_mask 
mic_mask 
Asta ttn_mask 
ENCCJreq mnask 
Mie cmd _ mask 
Dc rd cmd 
nic wr cma 


mic una 

mc blksiz 
mee 1510512 
fice OSt spt 
mie. Astolk 
more secsnf 
mic cpmspt 


mee SeCmsk . 
mic_wrall 
MAS wr air 
pc wrual 


equ 
equ 
equ 
equ 
equ 
equ 
equ 
equ 
equ 
equ 
equ 
equ 
equ 
equ 
eau 
equ 
equ 
equ 
equ 


SBcEOTCElockine/Debolocrcring 


equ 
equ 
equ 
equ 
equ 
equ 
equ 


equ 
equ 
equ 
equ 


mov 
out 
mov 
out 


veculcieo 
2002002vt 
COBCESYBd 
ervelezlo 
002000190 
20000011b 
c000€190£0 
vergcudizlo 
vuVOoVVico 
c00171190 
veolceuv1o 
POE E DG 12 D 
KCCK LOC EC D 
1710022906 
1LULCLELLO 
2012209070 
0002200€11t 
Zen 

dern 


Byte pir [BI] 


16384 
Drs 
24 


write sjenaloott 
Status signal 
¿command signal 
‚data signal 
praputelaten Siens } 
‚latchesjenel of} 
‚output signal 
‚output Signal off 
‚select enadl> 
‚normal reset 

yi nput ready 
scutput ready 
„busy 

sattr or arey 
;attn only 

;dreg only 
‚command 
smicropolis read 
snleropolıs write 


Name or cyte at EZ 
;CP/M allocation size 
shost disk Sect size 
$2105t disk Sects/trx 


asis 1280270 ses ts/no5L Hurt 


2 


ugs mNCOnsopix) 


METAS Toi mie TS TS OL 


Mitos tol =1 


e 


OEM secerors/track 
¡Sector mask 

¡“Write to allocatei 
MSIE sc Lreclory 
¡write to unallocate 


scaled trom INIT 


D not loader dios 


al,mic_noce2_d_out 


Nave DOr tesa! 


al mic ack orf 


mic porte;al 


SE 


a— GIER o ciu m e L E O AA AO e O E GERD AED GERD CXRD GERD GER GERD GERD cuum A a e a A GER O O O we O A A O O e O O O O nep emus A TD E auus O E E O: DO O O A eme 


‚disatle all 
smesxatle 
VENLErTUPDLS 
sinitialize to mode 
4 and 2 

sinsure acknowledge 
yis ori 






m 
m 


, 
, 
H 
m 


<e Se we 


“we we we 


mov 
out 
mov 
out 
mov 


mov 
mov 
dec 
jnz 
dec 
jnz 


Bcormit 1: 
memrnit 2: 


SMS TD Ot 
Mieeporte , ai 
ay imeem ees 2 
Mic porto, al 


sinsure strote 
NUS Ot E 

¡set select ana 
;enable 


SRC ITE CE mirorst msesourtput reset 
call pmsg 


CX. 1e 
aX,27777 
ax 

mic init_z 
EX 
D 


Cae mic asta tus 


cmp 


alo mies ind Ta 


Je Miec init 5 
TOVON SETELI CRS TETTI OUTOU error 
Call pns2 


load tne 


meminit 5: 


push es 


nov 
mov 
mov 
mov 
mov 
pop 
moa vialize the 
mov 
out 
mov 
out 
mov 
out 
mov 
out 


initialize tne tirer and 


ax, 
DIA 


¡wait 1 serona 


‚get tne status 


stken retrırı 


VECUOGmoanuac tor the interrupt hardier 


‚want to aadress 
‚absclute Q 


arc ceto omiccldr VLsıinterrupt number 


SMC aX 
SSP uel SG es 
es 


Pte rut corEtroller 


al ric- icwl 
mici oic portli, al 
Simio 16w2 
Micmac e 
al,mic_icw4 
Tice ne DOr Ll. 4 
alone, OCwl 
Miewelerporte,al 


pusn es 


mov 
mov 
mov 
pop 
mo v 
out 
mov 
Out 


ax,cmemseg 

EUST 

Mic Stat Dyte, c fn 
es 

al,mic mode centl 
mic mode port,al 
al,mic 1sb value 
ICAO UAT port, ad 


292 


store 10581 ptr 
sand cs value 
restore extra ses 


0 
UGert <1.% 
Ontrol word € 
Mop tat 
a 


t masg register 


set tne status Dyte 


isave ertra ses 
sto ddiíress common 


sany non-zero val 
‚core witn status 
‚set mode 


FLOW Court value 





mov al,mic_msb_value 
Ju ce at port,al 
SI 
ret 


; 
H now set up the interrupt nandler 
; 
mec int 72: 

pusn ax 


‚nigh count value 
¡Start timer 
restore ints 
sand return 


¡Save state 


H Set tip local stack for interrupt nandler 


mov saV_ptr,sp 
mov sav seg,ss 
mov sp.otfiser Int base 
mon ax yos 
mov SS,ax 

pusn es 

push bx 

push cx 

pnsn 27 

mov ax,cmemsse 
MON Me Ss ax 


saye stx peinter 
¡Save seement ree 
‚ser local pointer 
¡set local seement 


‚make cormon 
saddressaple 


MOE SAO al mic stat oOyte ;eneck status 


cmp al,¢WUn 
ioc ome. tern _-2 
mov al,mic_cmd_byte 
ondal mie cma mask 
emp al,v2 
J mo Trei l 
Call mic send 

mee wr 1: 
Calin mic status 
test aili mic masr 
Jz mic wr-l 
tost 3l mic atta mask 
gno Mic treri 
MOY XU LZ 
TOTO DX Dix 

EC wr 2: mov al mic court [ex] 
came cata our 
AO 
Mec dx 
B N EC 
ID HIE E 


Biesread_1: 

call mic send 
Gabie mie status 
testa ll, mic uma SK 
eee read e 


pie Tread_2: 


152 


‚actier neede4? 
;no then return 
‚read or write? 


read? 
¿must be write 


‚get Status 
ame sor alın? 
¡een cnectcine 
‚was it attn? 
ives, all däre 
¡set courter 
clear bx 
¿send data 


;Check status 
stor fihat rseult 


na commana 
to ste tus 
Sa Or artti? 





mic read 3: 


ves elote A 
jnzepie terr 

MO IST 

AO DA 

coi tc data in 

mov mic_buff|bx],al 
inc Or 

dec ax 

memi read o 

Ino mic read e 


noc term: 


gan D 

Call miclirdy 

call mic data in 

and ala 

cama roh 

JZ Vic tern 1I 

mov mic stat byte,.CUftth 
JIo mic term < 


mic term_l: 


mic 


"6 9 € 


=e we 


mov mic_stat_byte,Zah 


Mera 2: 

ax 
Cx 
ox 
es 


pop 
pop 
pop 
pop 


restore old 
NOV Sp,sav ptr 


mov ax,sav see 
mov SS,ax 


A bee OT 
‚yes,all done 
¿must ce crey 
‚clear tx 
‚ser data 
„store 11 


in buffer 


salt on cniri 
terrication 


E 
wer 4 only 
oc 


uccess? 


indicate failure 


indicate susress 


;restore ail regs 


Stack segment and pointer 


Bee ai nalzpop Of ax reload counter 


Boa Mic So Value 
Ort Mic count port,al 
mov al mic nso value 
out mic_count_port,al 
pop ax 

ITET 

ENDIF 


155 


‚least sig value 


»courter starts 


GU E m — ee ee l amm A a MAD -—— MD e r m ť‚șX/Á 


‚master ard 
‚ lSeder tios 






not oa 


SOME Nte selected 
mic home: 

mov al,mic_hstwrt 

poscat af 

Jaz mic nomed 

moy mic nstact,2 
mic_noned: 

ret 


SELECT DISE 

BESeIlECSK, 
elect 115% 
mov cl unit 
mov mic sexdsk,cl 
is GOL ote eta rst 
Ds LET 
gea micsselset 
EUnlsebesvne first 
DOV micas .de t..0 
mov mic unaont,ü 

Mire SCLSET : 

rart 


den Dios 


entered from EOMES jump 
4isk 


;cneck tor peniinz write 


Clear host active rlaz 


Sa berecde som SELBER Jump 


activation of tne drive? 


150 Cx 


actlvation. clear nosh “usr 


; SELECT TRACE enreredscdıter Sila AL juny 
MIE Settrx: 

„ser track given ty registers CX 

Moveema Cc sektrk,C A track Lorseek 

DET 
; —————————————————————————————————————————————————— 
; SELECT SECTOR entered driter SETSEC jump 
Pee setsec: 

set sector given by register 21 

Mov miezsexsetc,cl Sector LO SEEK 

Den 
, mn Gun ee eat ee O O are E e SO cee eee ce ere cee eee cee ee ro ee ee ce ee ee ee we ce ce a aim ee ee ee ee ee ee ee ee es we es oe ee e 
; READ entered after READ jump 
ioe read: 


„nedasrnesselesten 
mon smiesundent,? 


CP/M sector 
Clear únallocated 


pa 
Pp 





mov mic_readop,l ‚read operation 


mov mic isila, ¿must reed deta 
movenleswrtype, micewrual reas as unallos 
jmp mic_rwoper ¡perform tne reed 
; À — m qe AD M a MR V apum Uum cr Vu» vie f ED uum cuum e i r ee Vue EE dus X ee um Ge cum em ED Mu C M Vu ue E Ue uo uus Uu Ue Ue uo ee ee [lÁ 
H WRITE EO Il TR Jump 


Die write: 
¡write the selected CP/M sector 


mov mic Teadop,? write operation 
Tovembeswrtypsycl 

emp cl micowrual ele Umea loca tSd y 
poe mic Cokuna ,Feneck 1Or Uhailoc 


MelvemrOomunds located, Set parameters 


we We we 


Dovamilcsennarat, (mie Diksi2/12e) snext unalloc recs 


mov al,mic_sexdsx TAS t0 SECK 

mov mic_unadsk,al ¿MIC Unddsx = mic sekdsk 
mov ax,mio sektrk 

novemiceundtrk. dx ¿mMic_unatrk = mic_sektr 
mov ral. mc seksec 

mov mic_unasec,al pa SeUMa> ec — Imre Sexsec 


we we 


Ec TOR Bloc&/Veblock Subroutines -----=7 nn 


mic_cnkuna: 
,cneck for write to unallocated sector 
H 


mov bx,ottset mic_unarnt ipoint UNA’ 

sat UNACNT 
moveal.mrc una 1 test al,al sary urallc remain? 
fie ic alloc ¡sip 1f not 


we 99 


more uzallocated records remain 
dec al ¿Mic Unacat 
7= Miceeinacn ti 


mov mic_una,al 


noy al mlc sekdsk ‚same disk? 
Moves, OLtSet mic unadsk 
Cup al mic una smic_sekdsz 

‚= mic_unadsx? 
Mia loc osipi iit not 


we we 


aiszs are tne same 
mov AX, mic_unatrx 
Cmp Až; mMIC sektrk 
joz micralloc jezip if not 


"9 





racks are tne same 
moOvedl, mie Sseksec 


we 


"9 


HOV, Ol tse Mic unasec 


emp al mier una 


Jumbo tacos 


we we 


ASCO neve tomrexzt sector for 
mmie mic una 


HON Halo mic Una 
ao e 
Jo mic nooyf 


OVeri ilow tOo next traca 
mov mic_una,d 
fne mic usatrK 


<eo we 


) 
mic noovf: 


+ 
de 


‚same sector? 


¿polis ura 
ae une sec 


imic seksec 
ic UNES eo 
OO 


uture ref 
»micsuHasec 

= miemunasec+l 
send ot track? 
FCOUDtEG-7 Sectors 
‚skip if below 


jmLCeunasec = 0 
smic_unatre 
= mie unavrk*l 


snaten found, mark as unnecessary read 


Move ueensiiag, 0 
ÜUmps mic -rwopsr 


) 
mMietalloc: 


umeeerse 132.029 
perform write 


snot an unallocated record, requires pre-reaa 


mov Mic nnac, 
MOVvoMmLe rsilaz,l 


; Common code tor READ ana WRITE 


mic_rwoper: 


foe eee LO pe TioOrm tne 


mov mic_erflaz,£ 
Mev al, mie seksec 
DOV cl: mic smoshf 
SARIC 

PON mnessexrnst,.dal 


RESTE Mos o sosctor? 
Mov pad.) 
Teno Mal mle nstact 
eo old, ot 
weenie teins t 


t 


imic rnracnt = % 
mie rst iag = I 
jarop taronen 
ItO reoper 


ollows 
read/write 


¿no errors (yet) 
ycomonüute nost sector 


snost sect to seez 


jalways becomes 1 
¡was it alreaay? 
feos 1. not 


shost butfrer active, same as seex burrer? 
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Mov HE Ssexcsk 
ep dl, Tic .nStisk WI) ees e ds 

‚= mic_Astası? 
az mic Nema tes 


sSame disk, same track? 
mov ax omc NSttrk 
enp ar,m2ch sektre Mos track same 
jas Seex track 
Jaz mic nomaten 


Sm same tracz, same ET 
mov al,mic_sekhst 
emp al. mic HSTSEec Mic se Est 
SS 


m 
skip if maten 


we we we 


j2 mic match 

mirc nomatcA: 
roper disz, vut not correct sector 
"nov al, mic hstwrt 


p pude UP ? 
ico mic filnst NO Lon C arite 
call mic_writenst yes, clear 

Dost bult 


) 
mee filnast: 
¡may have to fill the host buffer 
mor al nie sexack ! mov mic_Estdsk,al 
me vr rar omic sekirz ! mov nic nsttrE.ax 
Toei y Mac eseknst ! mov Mic Nstsec.al 
Noval sme rsfileg 
Pest alas BReec to read. 
Econ cest 
3 
sqm cenesdhnst ‚yes, ir 1 


, 
meee tilnsti: 
Mov mic _ Astwrt,d ine pende 


”3 
ct 


fee Taten: 
NeOO Gata tO Or from butter depending on mic readop 


MORA mie seksEC mase nu ten number 
amo par mic secmsi 
pouci. 7 i snl] ar Cl onr t Left Y 

JO ET Cu uo) 


ax hàs relative nost buffer offset 


~wewe we 


aaar Ort set mic nst bout jax nae buff aadr 
mov si,ax ¡put in si res 
nov di,dma adr MS is 


yos pM rede DD 
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push DS ! pusn ES ¡Save Seg Tegs 


<o 


Coie SS Se 

LO PAS ISES SOE 
SI Ar anda CS/ 55 
is swapped 


nov ES,dma_seg 


It write op 
MOV or S lenetn of move 
mov al,mic_readop 
Bestsal,at which way? 
nz mic_rwmove skip. ii: read 


"9 we 


Write operation, marx and switch 
nov mic nstwrt,l 
dirty ourter now} 


di 

mic_astwrt = 1 
(4 

SOUnCE/CeSt SwdD 


gene Si ,di 


Mov an, DS 
mov ES ax 
mov DS,ama_seg „serup US hs 
3 
mic rwmove: 
cla ! rep movs AX,AX ¿move 15 bit words 
pop Hs | poo DS ¡restore seg Tegs 


data nas been moved to/from nosti bufter 


we we 


Enpemicowrtype,mic wrdir S E 
TEE I errors 
az mic Teturni_ Tw Ino OrocessSins 


"oe we 


clear BOSt butter for directory write 


test alal errors, 
oe cme TUT Ty SS O 
mov mic_nstwrt,t£ ‚buffer written 


ea MIC writenst 

Dov al,mic»erflaz 
fee return rw: 

Ter 


a 
+ 
21 
+ 


EEES RRE EAS ays HE AS SHS AS AS AS AS BT AS BITRE OE AS AS AT AES AE AS R RE RE RE a 


, 
, WEOROPOLISSHARD DISK SUBEOUTINES 
j 


BE ARAS FETE AT EAS AS AEE BE AE AT HE BE AE BE FR AE AK AK 3K SE RERE NE RE AE AE AE AE RE E RERE AS SR RE RE AE AE SR SE IE SR AR AS JE ESR AE RS KE XERE RS SE 


Pa readnsrt: 
poy mic dair, dicate redac or Write 





eli Diese De Sue 
call get common izet resource 


ENDIF ¡master and not 
sloader_bios 


LE Mot master add not loader bios 


-e m m ra m es ee ee es we m r e e r m r m L Á d GEED Cum Ss es i Se ee a am 


call request ‚get resource 
, en => en an wes => an e» «> an >> en es an en an en an an an an em es am am am «e an qe <> e ee a er o e a m i d he g E a EA A A ew 
ENDIF ¿not master ana not 
‚loacer 


Moo. mic_ ra ema $s2t up read cmd 
eallunıe set ‚set up parameters 
ean ie Nec at rans stransmrit ther 
Car amieat vans burt 7220 vnezmburter 
cate tease nnoedcgocN Pes ncs 
Tovah, mic result 
mov miclertlag,al ¿estab ltsa Error 

= ____------__2_-___-_---- --- - --- 2-22 --- - ----.-- 
ENDIF ‚naar !oader bios 


sti restore int 
, oe a ae oe we ow en an «> en an an e» en en en e a a a e a e a A e es e e es o a e o e e e e a e e A e O e O O O O e e dumm Gum a E a A s 
BADER master and not 
‚loacder 


Mic writenst: 


movomic dir,1 gnolcere rd/wrt 
mov al,mic nst dsx ICK TOT valid wrt 
Spal user 

OAMI CNTT err maalcdatre error 
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eli ‚clear to be sure 
‚zet 


TSeSoE. re 


ENDIF ¡master end rot 
‚loecder 


enormes verzamdsnor loader bios 


palT request ISC RESOURCE 
, -e aeae ao an ae o co SU anap 4m SE ee TI I T 7 D e O ee ee ee o en en ee we O e o r o e E GEO re o GE O es a O A oe e 
ENDIF snot master and not 
loader 


nov Di mie wr cmd pStODEWwDILB cmd 
call mic set ¡Set Up parameters 
call mic trans our* ¡trausmit Butter 
pallamrc trans tranemit parameters 
Gal release pueveaserTesource 
non al,mic result 
mov mic erflaz,al 
ITD NIC vrt Ter 

DECEWrt err: 
TONO OI St MLIO vrt mse 
call pmse error messase 
Moy mic erflag,vffa sıinalcate tre error 


mswru ret: 


O e E e E O e E — ae of ee ow GD O O oe oe ow r oe CA oe eo oe oe oe oe oe dune ew ee ee oe ee ee i Gum cm cum 


, GD QUE EE ae ED we es SO or E A AO EE O QUE O AO oe o GE A AUD CU CE es o es O A A E O EY DO e a E O SO e es oe oe es o ED ne at a e 
sti ;restore int 
, -e an an aD a0 aD A ao AO TD o GR GD ED q SU ee ee re oe we ee ee oe ee oe ee ee oe os o o O oe es ee es a GE E A aad 
ENDIF master end not 
sloacer 
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IO TO a der bios 


pusa es 

pus 

pusn cx 

pusa 0x 

mov ax,cmemsee 

mov es,ax 

mov mic cmd byte, ol 
mov dl mic nst asz 
SID 

mov cl,& 

sol 5I.cl 

mov mic permi, 0l 
"nov cx,mic hst trk 
Move Mm. cepa nha. Cl 
mov mel parns,ch 
MOV! mec St Sec 
Mov mic parme,z 
movente perms, 1 
mov mic_parm6,d 
MONTO 0YTS, 
pop ox 


mecetrens: 
push es 
pusn ax 
mov ax,cmemseg 
ROME S Pr 
mov mi^ Stat oyte,£ 


on 


Gm CE cm, m ee eee ae SS SSS SSS SSE ee eS EB GERL m 


‚make common addr 


¿type of cormanc 
sad) tor head nun 


= 

13 

rA 
ct 
fw 
13 

a 
= 
a] 
107) 
$2 
[Vi 
(D 
ct 


LYK now Set 


SETE 

sony one to process 
snot uset 

¡St 20 tyte 
‚restere regs 


we 


Sorcesintereent 





ENDIF smaster and not 
;loader 


IN not loader dios 


© m a ee ee ew ee oe we D D we we ce O we es A CO E CI (O E E O T ce a See ee ee ee SS Á lX RÁ 


) 


mac trans_1: 
mov al,mic_stat_byte ; 
cnp dl, 2 ‚a 
Izenıc trans 1 
Cup al, dan ‚success? 
emic Success write 
TOMC resutflt,eitn mece Tailure 
mop mic fall write 
DHcESuccess write: 
Move Mic result con 
mec tail write: 
pop ax 
pop es 
rey 


Wo trans _buff: 
pusn es (oa Lees 
pusn ds 
mov ax,cs 
mov eS,ax 
novsaısortset mic 2stout 
mov ax,cmemseg 
Mov ds ,ax 
"ov si,5172n 
Mov Che eso 
eo mic tr, e 
ne trans burt I 
mone si,di 
mov ax,41s 
MOV e5,ar 
"OV ax,cs 
mov dS,ax 

Gee trans buff 1: 
cld 
rep movs ax,ax 
pop ds 
pop es 
ret 


ENDIF ‚not loader_bios 
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showtimes sere only used 
IF MASTER and not loader_bios Poy ierte rrept randier 
‚Subroutine: mic_status 
entry Conditions: non 
Exit Conditions: al contains status of disk 
Registers alteret: al 
Subroutines called: none 
meescription: 
H This subroutine reads and returns tre current 
svalue otf the Micropolis disk controller’s status port. 
1 
mee Status: 


mov. a mie stat inanes tatus tinge 
OUT MPCs porte ya 

mov Mica SU Don UU O Tea 

Or Mic porrto,al 

mov al Mic Strid on laten tne Stavus 


Out mic_porte,al 
POV dl MIC STD oTr 
our mic port2,al 


Mov al mic retro orr ¿tura oft rea 
out mic porro al 

ta al mici porta sbring in status 
pou 


;sSubroutine: mic send 

peutry conditions: parameters are calculated and in 

1 TNE byte variables 

sExit conditions: parameters and commanc nave teen sent 
;Revisters altered: nore 

ENnUrTovtines called: mic busy,mic ordjy, 

H HTH TIE HIE date cut 
sDeseription: 

H The commend byte, <l 
mena the go byte found in the data a! 
mene Cisk controller. 


; 
mic_send: 


Call mic usy Meli OT CRIT 

cou ne COTY 

Ac Oy psend out cme 

TOD DL. Dx clear bx 

mov au, ;set count value 
mowsend 1: Carll mic usy alt torsentn! 

Call mic ordy 

mov al,mic parmilor] ‚get parm 

alte data Out ¿send it 


163 





OT T 


decal ‚done? 
Jaz mie send I nmel another 
por 


meroutine: mic cmd out 

ntry conditions: ordy signal ñas been issued by tne 
disk controller and “cmd_oyte” 
contadas tone conmand to te sent. 

conditions: none 

eisters altered: none 

Broutines called: none 

Serıntion: 

The command in the byte variable ’cmd_tyte’ 
is sert to tne disx controller. 


te CA 


J we we we we we we we we we we we we 
Ww Os tg 
(DS 1D » 


Kern] out: 
pUS@ ax ¡Seve ex 
mov al,mic cmd byte 
QUIMICO Rial OMA Tee Tona 
moy 11, mic cmd ¿Enable ema. line 
out mic porte,al 
TOV aie see on sactivate output 
our mic porte, 2. ‚turser 
mov al,mice wstre_.on PUSE tne write 
OUtaemie sport bd 1 ‚strote 
moy bo 0 
OUT Mic porto, al 
mov al mic acc orf ;de-acrivate tne 
our mic porte,al pourput nufier 
pop ax . 
ret 


—— — — — ae ee ee ee GEN oe a uum ee cue GERD SEED ee cue ee E e B E ee ee ee O ee ee ee ee ee ee ee es es ee ee ee ee oe ewe = an oe oe cum 


3 

Nubroutine: mic data out 

¡Entry conditions: “ordy” siznal nas been issued ty tne 
disx controller and al contains valus 
to be sent. 

Mert concitions: none 

Registers altered: none 

Subroutines called: none 

Description: 


"9 "99 «9 9 dg “0. We 


O ia ES iS output To the Micropolis 
NES SX unit. 


) 
Gee data our: 


push ax ¡save ax 
cüt mic portaal ItOO Airesctionil 
Mov alfie arta ¡enable data líne 


euteniczpörte,dal 
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mov 
out 
mov 
out 
mov 
out 
mov 
out 


pop 
Dot 


au c nae On 
Wremporte,al 
Geet G aw Siter CON 
mic porto,al 

al mic strb_oft 
mie Spor TD ad t 
aügvmic ack Off 
miec porte,al 

ax 


soubroutine: mic_data_in 
memtiry conditions: 
; arekseontroller 


PAG TEVave CULDUT 
‚butfer 
‚pulseztne’write 
;Strobe 


;»de-activate 
PONT put cui Fern 
¡restore value 


“irdy” siznal has been issued by the 


momar te conditions: al contains data byte 

‘Registers altered: al 

Pop routines called: none 

Description: 

H ETT HDL from tne G TPO PO 11 S 


SI unit. 


7 
mic_data_in: 
mov 
out 
mov 
out 
mov 
out 
mov 
DU 


al mrC Jata 
mice porte,atl 
agas UTD» 
mic porto,al 
amic Stro on 
Mic apo Nte. al 
adios uo Off 
mic porte,al 
Mov al niec TSstiro_ orf 
gut mic rortb,al 

an al,mie2port3 

ver 


Entry conditions: none 
Ert conditions: disk controller has 
sienal 


efristerse altered: 
NUbroutines called: 
Esceri»tion: 


none 
PACESTITUS 


CJ (A o 


Me ELecutine program 
until tne disk controller issues the 


we we Yo we 0640 . th 99 9 


mic busy: 

pusnc ax 

Callim Ce Status 

test al,mic busy mask 
J? mic Dusy 1 


foes OUSy_1: 
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senable data lire 
‚turn tne read 
Or 


slaten the data 


yee sons. Toe 
read signal 
‚brine in data 


issued “not busy” 


will wait nere 
mort busy sienal, 


‚save ax 
seet status 
‚busy? 





pop ax 
ret 


uDroutine: mic irdy 

ntry conditions: rone , , 
Ust conditions: disk controller nhas issued irdy 
H signal 

Registers alterea: none 

moroutines called: mic_Status 

meescription: 

H The execution of the program will 
¡wait here until “iray” is issued by the controller. 
3, 

mec iridiy: 


push ax ¡Save ax 
meee irdy 1: Call mic status FECT Status 

test al;mic_1ray_ masz ‚ready? 

ya smleeirayel 

pop ax restore ax 

ret ¡ready row 


gDroutine: mic oriy 

MET y conditions: nona 

But conditions: disk controiler nes issued tne “orcy 
; signal 

‘Registers altered: nore 

memorosutines called: mic status 

meescription: 


< 


The ex 


Scutisa ot ths prosram will walt 
were until “ordy” is iss 


ved by Che controller. 


pusn ax ¡save ax 
mmworiy 1: cali mic status ‚set Status 

Best zal,nie Ondy mask ‚ready? 

Jz mic ordy 1 ¡Lot yet 

DOD dX 

ret 


eet common: 


Busn.2s 

pusn cx 

mov ax,cmemseg ‚maxe common 

mov eS,ax ‚memory aadressable 
call ticket ‚zet ticket number 
Epox „server vit LIcCKeL=server 
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je get common 4 

Rov cx,deoun: 
get common, 2: 

dec cx 

Jaz zot commons 


;cnecx Micropolis status byte 


tner done 
¡delay here 


emp mic Stat oy Te, con 


je get common, 2 
emp 0X, server 

je get_common_4 
Mov ex ,deount 
jmp get_common_2 


Nas tavus byte of @ needs an interrupt 


get common 5$: 
A 
mov Cx,dcount 
Jmp set_common_< 


get_common_4: 
POD CX 
pop 25 
ret 


. 
) 


eseg 

Ore, L185 
fe ip 72 rw 1 
Hic cs. "C w l 

org 5@ven 
Mie Stat_byts Be: | 
mie cmd byte no) 
mic parmi EDO 1 
mic parma to 1 
mic parmi Dno 
mic parm4 DD 
fee, pars DII 
mac parms rom 
mie 20 byte OL 


19% 


execute int 


„end of routines 
sUsed by interrupt 


‚Status byte 
command code 
parameters 





org 5128n 


mic buff tole ourter tor lita 
=o o A a re r 
cses $ 
micrst_msz db cr,lt, Micropolis Controller 
db Resetting...^,€ , 
Peers t err do Chri \cropolı> Disk Rese, Error 
db cr,it, Use ot Drives E- L will ° 
ab “produce unpredictable results” 
dt OI Lt 
Mic wrt msg do Sips Write Access not ' 
10 Permitted on Tnis 7 
db “Drive”,4 


Ms pace for local Stack 


moe stack Tw 120 
mop dase equ ortset © 
sev ptr rw 1 
sav_seg TW 1 
mies dir ro i IANS direction 
pe result rt T result of Tay wrt 
Bee sek ask Du l ;Seek disk number 
mic sek trk rw 1 Seek Track number 
MAS ek _ sec rb l see Se [Or number 
mensi dsk rt 1l ;host 21s< number 
Mec eNSt_tre rw 1 ;nost tracx number 
Mere OSt sec rb 1 js) “see Or enino0er 
Meee ses Ast ro L Sa SIT CSAT 
MiS Ast_ at DE 1 jos tt acCrive = tae 
mic hst wrt zb y post Written las 
fees una cnt rb 1 üunaliloc rec cnt 
mie una dsx rb 1 ilast unalloc disk 
mae una trk rw 1 nds USOS track 
mre una sec rd 1 ids ta Una bor sect 
me ert lage rd 1 Hello: Reporting 
mie rstlae ro T pueda coc tort lar 
mic_readop ro 1 pL itera 6 pe sation 
mic_wrtype NO l swrt operation type 
mic_nstbuf rb Mees 0-512 ¡nos Cutter 
A ee —————— e 
EN DIF 


Tos 





APPENDIX E 


PROGRAM LISTING OF CPMMAST.DEF 


The followine disk definition Statements were used with 


tne GENDEF facility to generate tne disk tarameter tables. 


disks 12 
diskaef 2 
diskdef 
disxdef 
disxdef 
disxdef 
disxdet 
da skaet 
disxcef 
diskdet 
Cues eet 
disxdef 
diskder 
Saeed, 


OCR OCS c TE, 
AIDA eto DA Ot, e 


NM OO 


SA AG PRR 


TOOR OSEA er Lees, 1 


"c9 y 


IO NOISE, 199,290, 0 ,É 


(T J Q ORO nr 


* = -J J 


pas Ha 4 
pa IT o 
^ y 
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Tne 


n 


PPZNDIX 


KE 


4 


PROGGAM ESTING OF CPNMAST. LIS 


following CPMMAST.LI£ rile is created by tne GENDEF 


DIJIity wnen the CPMMAST.D5sF is used as tne source file. 


DESKI IA 
equ 5 ‚Base of Disx Farameter Blocks 
dw A A e sIransiate Tacle 
dw Coben galon ‚Scratcn Area 
dw dirbuf,dpbZ ¿DI suri, Parm slock 
dw csv¢,alv@ UA AL loc Vectors 
dw xıit1,2200n ‚Trarslate Table 
dw C¢CSeh COLEN ‚Scratcn Area 
dw dar reur,.dnol JDIDSButt. Parm Block 
dw esvi,alvl y»onecc. Alloc Vectors 
dw Cte, CO Can ‚Translate Tacle 
Aw €000n ,2702n ‚sceraten Area 
Aw Qi Pout ,a pod polar Burt. Parc Slock 
dw esv2,alvy> isc. Alloe Vectors 
dw x11t3,206€n ¡Translate Table 
dw Ellen ,<eed¢n ‚Scratch Area 
aw G@irbhur,d poo Hoar Burr, Parm Flock 
dw CSVOsalVo SHI Alilcoc Vectors 
dw xl1t4,24000n ‚Translate Table 
aw Teon, goen socraten Area 
dw aı rcuf,dpde IAB Farm flock 
dw csv4,alv4 Check, Alloc Vectors 
dw DTO, CLECA ¡Translate Table 
dw geaen Bolen scoeraLen Anea 
dw Si rpur,d pos DI RPU Farm Block 
dw gevo 3l0lv5 j;Chneck,. "Alloc Vectors 
Aw x1t6,02U02n ‚Translate Taole 
Aw Caaan ecen ‚Scratch Area 
dw Gir tut ,c pos Br. arm Block 
2 CsvG,alvs unes Alloc Vectors 
dw Mie oer ‚Translate Taole 
dw ec20n,2v02n ‚seretcn Area 
dw irou, d po? SI Parm.210Ck 
Aw CSI a LV? Greek, Alloe Vectors 
dw x1t23,7000n ‚Translate Taole 
dw Leen BEZON Scratch Area 
dw dartur,apce DiC BUI. Parm Block 
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dpe12 


dpell 


dpd 


xlt£ 


als 
559 


, 
apil 


ntl 


dw 


dw 
equ 


db 
dt 


csvS,elv8 ;Cnecx, Alloc Vectors 


xlt9,20Len Translate Table 
000n,.£9070h Scratch Area 

ar ron ,dno> MU ee orm Block 
csv9,alv9 ;Chneck, Alloc Vectors 
xltil,eeegh ¡Translate Table 
DCO Dagen jocratcn Aree 
dirbuf,dpbi12 DOME Parm block 
csSvi£,alvi1£? ‚Check, Alloc Vectors 
xitıl ,2Veon ¡Translate Tatle 
e?20n,9900n ‚Scratch Area 

eirbut ,d poll plo eee Parm E LOCK 
CS vinim aV ‚Sheez, Alloc Vectors 
BISKDRE 2,1, 26,0,1024,71,092,0,2 
Outer s ;Disk Parameter Elock 
26 Sectors Per Track 

3 eE Dot 

H BLOCK Mask 

2 ;brtnt Mask 

72 ‚Disk Size - 1 

31 ¿Directory Max 

128 ;Alloc?9 

e AMRO SIL 

ð eneck ze 

2 ¡Orrfset 

oftset 5 ¡Translate Table 

E 

e AE 


1514155416 
118,19,20 
A O MES 


29,28 

9 ‚AallceıitmworıVecter Size 
C ¿Check Vector Size 
DUES DENIA. 20, 0. 102%, 23.04.02 
Set 5 ‚Disz Parameter ElncK 
25 Sectors Fer Tracz 

$ "dock Snitft 

? 8locxK Masz 

G sExtnt Masx 

242 pose Si rg = 1 

DS SU LTECEOrY Max 

192 sAlloc4 

e pil 

ES ‚checex S126 

2 Offset 

ofrřset 5 ¡Translate Table 


Ic lp 
c cQ Uu Dr 
Ze, yes 


DI 






db 0 IS 


db 2D 2c. l2 

db 18 ,24,4,1g 

db LS 
alsl equ $1 FOL LOcathLone Vector Size 
pssl equ 16 ;uneck Vector size 
; DISKDER 211 
d'obz equ dep jyEgublvalent Parameters 
als2 equ axe panel cantor Vector size 
esse eyu essl ¿Same Cnecxsum Vector Size 
x12 equ XT ¡Same Translate Table 
H ITH TE EE I 1 
3963 equ Offset 5 ;Disi£ Parameter Block 

dw 155 yoectors Per Track 

db 2 MESE E 

db Ta peloeck “ask 

db a ‚axtnt Mask 

dw 274 Disk Size = 1 

dw 127 ‚Directory Max 

d 128 ;Alloc£ 

aD à pALLOCL 

dw Y ;Cne^x Size 

dw 1 sOrttset 
mit equ offset $ ¡Translate Table 

db 1,2,09,4 

db Duce. 

qup Spee le 

1b I 550.15. 16 

dab ee aloe’ 

ab Ce ee Oye 

ab RON 2 2 

db 29.,.30,21,52 

db OO OOO 

db 37,358 ,39,44 

ab 41,42 ,43,44 

db 45,46,47,48 

4D ARO 1 02 

a 22, 94,92,°6 

dd 57 98,59,52 

dd 61,62,63.64 

db Senco .or , 05 

db po 7lI.T2 

dt Ow ae Oe CO 

db MINAS. SO 

a S1722 23,84 

1b SONO UE SE 

ab 32,20,91,92 

ab 93,94 ,95,96 

do 473,32, 935, 1202 

db Tor T02, 105,104 

db AS 


172 





3153 
CSS. 


? 
dprée 
als4 
rss4 
x1t4 


dpb5 
als5 
css5 
Peet 5 
, 

dpp6 
als6 
css 
mL 


) 
dpo? 


Mit? 


db 


equ 


ad 
d 
E 
db 
db 
db 
db 
do 


129.,110,111,112 
Bro la, 15,116 
WU ITE T19.12C0 
121 1225125,124 
129.12€,127,1283 
129513025.151,182 
1859,1342,15953,136 
157,013558,159,140 
141,142,143,144 
145,146,147,148 
jeg road 191,152 
yo O oo OO 
e 

DISEDET 4.5 
ipb3 

als3 

mss 

xS 

DESDE EY 5.5 
dpog 

ass 

ES 535 

xl 

DISKDEF 6,5 
dpb3 

als3 

ess. 

KUVO 


DESCDEF 7,0,25,9 


Optsot S 

3€ 

> 

127 

> 

434 

255 

128 

e 

e 

2 

offset 5 
Be, 
AO Y 
2919,11 
»2,15,14,15 
LS. LS) 19 
207 21,022,09 
2an 25,20,27 
2229 ,50,31 
=2,2,,54,55 


aoeatlon vector Size 
ponecrtctvectror 51476 


¡Equivalent Parameters 

Sane Ailocation Vector Size 
‚Same Cnerksum Vertor Size 
Same Translate Table 


; Equivalent Parameters 

same Allocation Vectcr Size 
yoame Chacesum Vector Size 
Same Translate Table 


‚squivalent Parameters 
Sanesıkloeearionsveetor SIze 
yoame Checksum Vector Size 
¡pane Translate Table 
sIESNA 455,255 LL 

¡Disk Parameter Blo=x 

jee tonrs Fer Track 
pplocroonifi 

Block Mask 

pS Got Vast 

¡USE size > 1 

¡Directory Max 

SAO ce 

ALOI 

‚Check Size 

Offset 

¡Translate Table 


Me 





als” 
css 


) 

dpb8 
als8 
2ss@ 
mite 


? 

dpbY 
als9 
css9 
mig 


y 

1p512 
als1Z 
esslß 
melt 


’ 
apmoll 
sell 
css$11 
GI 


“we we wo we 


besdat 
peer Ou ft 
alv 
csv 
alvl 
csvl 
alv2 
ASVZ 
alvs 
csv 


db 
db 
a 


db 
db 
db 
ab 
db 


db 
ab 


ab 
Gyo 
equ 
equ 


equ 
equ 
equ 
equ 


equ 
equ 
equ 
equ 


equ 
equ 
equ 
equ 


equ 
equ 
equ 
equ 


5 58.99 
49 ,41,422,43 
4&4,45,46,47 
#6749 .5¢,51 
Seon Of, 50 
55997. 58,59 
E06 1,02,09 
54065, 66,67 
62,69,70,71 
ESE de 
TORT TS TS 
Bole. oe MO 
AOS O ON SA 
88,89 ,9¢,91 
92,93 ,34 ,95 
55 

e 

DISKDEF 8,7 
apo? 

als” 

ass? 

Ce 
DISKDEF 9,7 
ep? 

es 

css" 

rip 


DITS- DEF 10,7 


apo? 
ais? 
pss 
LT 


DISK DEF 11.7 


and? 
Que 
css"? 
xt 
ENDEF 


Aoc ation Vector Size 
;Cneck Vector Size 


; Equivalent Parameters 
;Same Allocation Vectr Size 
sSame Crecxsur Vector Size 
‚Sane Translate Taole 


sEquivalent Parareters 
‚Same Allocation Vectr Size 
;Same Cnecksum Vector Size 
¡Same Translate Table 


Equivalent Parameters 

Sane Allocation Vector size 
Same Checksum Vector Size 
Semen Tans ate Table 


uivalent Parameters 
ne Allocetion Vectr Size 
mes Snaeexsum Vector 5128 
me Translate Tabie 


nv» wO 


Anta laized Seratca Memory Follows: 


equ 
rs 
rs 
ps 
rs 
rs 
rs 
rs 
rs 


rs 


offset S 
128 

als 
csse 
alsl 
ESSL 
alse 
css2 
else 
cssä 


„Start Of Scretcen Area 
‚Direetory Eufter 

eet or 

;Cnecxz Vector 

saıloc Vector 
scnecroy/ector 

ALO Vector 

‚Ccneck Vector 

‚Alloc Vector 

sCRecx Vector 


~-o. 
D> 
hb 
— 
O 
O 
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alv& rs als4 sålloc Vector 

csv4 rs css4 ¡neck Vector 

alv5 rs als5 sAlloc Vector 

esv5 rs 2555 ‚Check Vector 

alv6 rs als6 sålloc Vector 

csv6 rs css6 ‚Check Vector 

alv” rs als"? sAlloc Vector 

esv? rs css”? sCnecx Vector 

alv8 rs als ,Alloc Vector 

csv8 ES cs<8 nec Wector 

alv9 rS als3 s4lloc Vector 

csv9 rs cssY ‚Check Vector 

alvi£ rs als1¢ sAlloc Vector 

rsv12 rs cessió sCrecx Vector 

alvil rs aisti ;Alloc Vector 

esvll rs css11 Scheck Vector 

enddat eau ofrset $ s£na or Seraton Area 

@etsiz egu SES DOE dai ze Of Scratch Area 
ad e ‚Marks End of Module 


Lvs 





APPENDIX E 


PROGRAM LISTING OF RXFLOP.AS6 


"Jg 


mee Name : RXFLOP.AB6 (REMEX FLOPPY DISEK 
ACCESS CODEN 


wWe~we wea we “o. 


Date Soe ori boas 

Moditiea by: Mark I. Perry 

For : Tnesis (AEGIS Moaeling Group) 

‚Advisor s Frotessor Cotton 

¡Purpose SITAS code is an duclude tile w/1n CPYEIOS.ALO. 


It contains tne nco de necessary to access tne 
Remex floppy dis« drives and gererate a 
Ioeaderzrorzstinenm. 

Rai sscortlsuratjon is set for CP/M Logical 
drives iA: S P) ani (Cs). To alter 
change code in READ ena WFITS routines. 


We WE WO We We we 


BS AE HEAT EHS HEAT AE TAS YS KE I RE BE XS AE SE AS KE AE RE DE AE AS F E AE SR AE IE SE SE KE SR AEE SA IR KE AS FR XE XS IR FR XE IR IE S XE XE IA IR XR XR 


Buuatss 


HE ARSE AE AE AS RE RE SR IRIK RE XR AT AS RE EEE EEE IS BS BE SE AS HES OE 3S ae BAT ASA AH A AH AR RE 


we We we 


¡=== Disk Controller command bytes and masxs [REMEX) --- 


dk rdy mask equ 98H 
dae ra cmal equ 1411 pr Gad command 
mr rd cm42 equ 1812H 
ak wr cmil equ 1¢21H ¡write command 
dx_wr_cmd2 SI 
Briss equ 12 
drive2 equ 2 ¿CPM logical 4SK # for 
‚drive 2 
EN 5s Intertace Controller Ports ——--—---------—-- 
cmd reg equ 70H petrlem sitase in CP/M-BS 
status_reg equ "71H 
pzaädr lo egu 72E 
peaddr hi equ 73E 


KRKK KPE RR R RA R IR AE E A A A AA RR A A A IATA A AE 
QPM DEVIOS SPECIFIC CODE 
entered from the main CPMBIOS s jump vectors 


’ 
e 
? 
. 
, 
3 ER AK NE E KE FE IIR IEIR RE IE RE KE IE HE EAE AK IK AE AE OK BRAS TE AK ROK AR OS AS OR AR SE OE OK At OK OE ORK ROO AE AE KC OK IRRE RR XE 
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ret sno special action required 
, — mr oe ow oe a ow ee ae ae ae ap ao ae aD aD aD aD ap at O a e a e a a O a a GERD e re oe ee ew wn es wn ww O O vr r we ew we ee 
merlop home: 

ret sno special action required 


rxflop seldsx: 


IT unoeeperidlodoction requiced 


ret ‚09 Special action required 


jm Op Ssetsec: 


pet „no special action require? 





"9 we 


"0 we 


we "99 


9 


Enti: 


ENDIF 
Sali 
cail 
call 


ORCE SIT 


Peo WS Se 

unit drives 
Tal 
Da ra cemil 
Taz 


Dra rd emiz 


build_packet 
send packet 
XiT vuffer 


not loader D10S 


en 
request 
Umi UT eerivec 
wrti 

Coser ond | 
wrt2 


IC EME E 


‚torce a read on drive 1 


EGMESTETICKET Eunmtber 

PMI Oca 215.6 No. for 
Hemer rloppy arive 2 (C2) 
Step. to fa drive 1 (Rf) 


Ln bI Oty 


cemere 


‚not loader Dios 


;Dper.orm tne read 
PIT OPM burfer into memory 


WED ES O QU RED GERD ee ee O ee ee a ee A O O A A O A © ee ee A A A © EA A A GERD o ow O A A OO © © e A e Me © A e e A E oe GU GE 


Poo Ge oade TD Dios 


¡return sucress/tailure code 


PeCUUes: LLcket number 

VOe/Meloeical 415% No. fo 
semer iloppy drive 2 (0: 
¡setup write to drive 1 ( 


= alga 


Set up to wrıte arive 2 


I 






WETE : 


call budidw packer 
call yir ouffer 
Call Send packet 
call release jo recs eS OUT ce 
mov e SUSE ¡return success/failure code 
j 
, e te amw am ae i << ee r <i E eik e ee ee E A E ee es Os ee es ee ee ee a O A A e e O ee ee e i m e e e e e 
EN DIF ‚not loader_bios 
Bet 
EE EE E IEE A RRE REDE FE KE IE BE IEA KE NE AE RE RE NE RERE SARE DE RE SE FE IE SE SERE A IE AE RE RESA RE AE NE KENE BE IE IA BERR FE KERR AE E IE 
H REMEX FLOPPY DISK SUBROUTINES 
gE ARAL RENE HE RENE AK EAC HE I AK EAR AE AE AE HR IR IE IE FE FEIR AS DE DA AR AR RA A BR AR IR FR DA BE RE AK DE AR AERE FR RA BS BE BE BR BAAR E E RE AE 
bulid packet: 
puss eis ‚save es reesister 
mov ax,cmemseeg Set un es to address common 
TOV es ,ax ¡memory 
mov PRIMO Tens Or Seater read cole in packet 
TOV p Status,” NESST packet Status word 
mov ax,VcVU CH ‚clear register 
mov 3l, track fet track + 
NOV Barldack 00,2 % ‚enter track e Im packet 
"mov ax ,207€0E ‚set nead ro. to £ 
ade 21, s>eror set. seztör no, 
nov Be Eds ect, a y put nead. A sec &* 1n packet 
nov PUnensaddr,ET00n,address of CE“ pufrter 
TOV p_mso,¢¢¢en por ourer mS D 
mov PewoOrd count ,S¢ 3% of 16 bit words 
Eom es 
pe 


send packet: 


push es 

NOV ax,cmemseg 

mov BST 

NOV ISS iload count tor retries 
senal: 

in a status res 

and a, dkerdysmask ,csneck interface ready 

cnp al ,@8H iıseLt readv? 

une senal 1t not ready repeat 

mov al,lcH 
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OUT 
NOV 
out 
NOV 
Om 
cheok result: 
mov 
cnp 
je 
cmp 
jne 
jmps 
retry: 
mo v 


cmd reS al 
ax, @¢@4n 

p addr 10.21 
alsan 

peed wail lt 


ax p startus 
ax ,@@@1F 
success read 
ax ,@U¢@H 
retry 

COOCK result 


Geeerrecode, a! 


MOV postatus,€ 


dec 
jnz 
mov 
J7ps 


Stent 

sendi 

result .oF FH 

dk execute ret 


Success read: 


nov 


PS eu LL, H 


ar execute ret: 


pop 
D 


an ouffer: 


pusa 
mov 
NOV 
mov 
nov 
TOV 
TOV 
emp 
iz 
mene 
mov 
NOV 
mov 


cld 
rep 
pop 
ret 


we 9 we 


HEAL SK HE ASAE HSS AS HE AE AK A SE AE AL AT AE AE AE AS 


XE HK HE NE I TK AS LAC TE AL AL IK IKE AK IK ACE IE I 


es 


es ! pusk ds 
es,dma_see 
naa dr 
ax,cmemseg 
O 
si,2172n 
Ccx,04 
IE 
ri^ 

sindi 
3X,45 
esmar 


ds,dma_seg 


MOVS aX,ax 
ds ! pop es 


A 


Data 
35 75 


SBI TT TTT TE 
;packet offset 

¡transfer low byte out 
„transfer ni byte out 


‚load status word 
;cneck for success 


‚check for failure 


‚save error cole 
veleanetetus word 
‚reduce retry count 
pet Pe ety A GA TH 
1 


return Failure code 


‚ser Up Tor write operation 


snove as 16-bit words 


- 


RE IE AE 3K AE GAS KE AR BA AE B IA KE AE IE AE BE A AE AE AR GA SE AR IE Se RE AR TR AK A 


Segment Area 


IKIE XR SLIR IK IR NE AK HS AK AL IE AS TS AE IK ENS EIE IK IK IR IK KE KR I AR IR XE XE XE XR 





Ecce 
org 024n soffset of packet 


pemodifiers rw 1 action elorjeceal unit 

P status Tw 1 ‚zeturnegd status 

emer ack "0 Ea I oleo recaer 

menead sect rw 1 se lecrelamead/sector number 

penem addr rw 1 ¡buffer address 

p_msb rw 1 A eadeno St bulter address 

p_word_count rw) l SEO date Dlocx 

D nenn o ae a a aa aE 
cseg $ 

err code dd CH ‚uerünneasnener error coXe 

de cenrt dt CER 

mesult ro~ 1 

rwdir Bice i i9 = read; 1 = write 





APPENDIX I 


PHROGRAM LISTING OF LURMAST.ONG 


¡Prog Name :LDRMAST.CFG 

;Date a a Loe 

;#ritten by sMark L. Perry 

¡For :Tnesis (AKGIS Modeling Group) 
Advisor seroressor Cotton 

Purpose cones code” 1s an include rile within 


LDCPM.AE6. It contains tne device 
Wa0mes et Or a2CCess to Initialization, 
read, and write routines and was 
developed to accompeav the boot rom 


0 99 weee ` 


an —— ape iar mr A © oe oe m M. r P Qu oe © A © A A e E A e e > R E La S ee © GENS GUED GE GEO TE A oe A A e r V R m TU GUED Gu oe ee AMD GSP oe 


; DEFINE nunits 
units ab 1 sonly a single drive for the loader 
, 
, = meae an vr m mr em omen ae ap am am ap qe ap oD ae A e e P A e e e e E e e e e e e e e e e e e we we e O e D D D D t m b r —À 
; INIDILALIZATION TABLE 
intbl Givmpormt Se LD Txt lop init yum ad 5 Tomax 
dw € 
; 
; y ias n i Oe ee Oe ee ee ee ee ee ee we Oe ee a i ow we we we wwe e = a 
H BLDITLENAL OFESZTS 
H 


TO l AMO Sel TXrlop read 
WITD] ORSAI CON Le 
mint ol ENzoLtser rxtlop none 
erect l dw otfset rzrrlop_seldsk 
MOL dw offset rxflop settrk 
EE! dw offset rxrf!op setsec 
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PROGRAM LISTING OF LURMAST.DEF 


mais is the) disk detiaition statement used for the 
Euer routine. Tne system is configured in tre loading 
mice as a single disk system to minimize the Space 
requirements. 
disks 1 


aoc heet ee, 1,20,0,10e4,cee, 54,64, 
endet 


18. 





) 
dpbase 
d ved 


9 
dapnu 


xit 


equ 
dw 
aw 
dw 
dw 


equ 
dw 
db 
db 
db 
dw 
dw 
db 
db 
dw 
dw 
EI 
db 
ARO 
ad 
dd 
db 
db 
db 
equ 
SO 


Unsaltialjzed Scratczä 


equ 
rs 
rs 
rs 
equ 
equ 
IB 


PROGRAM 


PESTE UT LD MAS TT. LIE 


DISKS 1 


5 


xlt2,9002Uh 
Vella Luena 
AO OO 
csvO,.alve 


DISKDEROS51,26,0 


offset 5 
20 


offset $ 
Hee allo a lO 
San old, 1? 
A T 
2in2,2,12 
27025,0,12 
18,242,4,1Z7 
Eo 22 

Si 

16 

ENDSF 


offset $ 

1285 

als 

csse 

offset $ 

OETtseL >= DEStat 
y 


‚Base ot Disk Parameter Eloc«s 
‚Translate Tatie 
¿Scratch Area 

wir ee t sPorm Block 
Caec Alloc Vectors 
91224,243,64 ,64,2 
sDisx Perameter Blocx 
Sectors Per Track 
DER T 

‚Block Mask 

‚axıtnt Mask 

source zo.) 
‚Dirreevary Max 
sAåAllocg 

;A110CI 

seneck Size 

Offset 

¡Translate Table 


sAllocation Vector Size 
scmeex Vector Size 


Memory Follows: 


Start of Scratch Area 
pUirectory Eurter 
sAlIoesVector 

‚öoneck Vector 

una Ot Scratch Area 
Size of Scratcn Area 
s“~“arKks Ena of module 
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e 
a 


MH HR 4 


HOt 


we SO we Me St We WE we Fe we we We 
x 


2) 


ey 


444 443% 4 


$ 4 4 4 


4 7 


3 E HK ET 


X 39 3 


se 
aj 


3t 


we 964 96 «6 96 We MO 96 96 We «96 WE 96€ 96 96 We We WE WO Pe We We we we Be we De 9996 
HAY 3t 


3 X 


APPENDIX L 


PROGRA LISTING OF AMXROM.AS6 


BRFSS IE AE RR AE IR RED AR KE IA RE RE RE RE IR OE RE AR AR B AERE AE AE AK DA AE XE SE AE RE AS AE GE AS 25 26 26 


Mois is tne KOOT ROM wnicn is resident se 
an tne 95* monitor. To execute tne boot =~ 
me monitor must be brouent on-line and = 
Mae control passed by effd4:2 or ty n 
"etf1&:C0Q4 . Tne first monitor command * 
ERU i Boot to an ISEC 292 disk and tne AE 
second command will boot tc the Remex. = 
NES t, tne ROM moves a copy of its data =~ 
to RAM at location O0UUUPH, taen if = 
initializes the Seement registers and trne* 
ELI xa5oIsUer. Tue Lecoo peripheral int- ~ 
ace onproOller is setup tor interrupts ~ 
at 1H to 17E (vectors at €L242.E-«eLoFH) = 
and ezse-trigsered auto-EOI (end of in- * 
terrupt) mode witn ali interrupt levels * 
masxed-orf. Next, tne appropriate device% 
controller is initialized, and tracks Z N 
Sector 1 is read to determine tne target * 
Memaerapa address for LOADER. Finally., * 
meee GOADER on track Y sectors 2-26 an2 to 
tracg 1 sectors 1-25 is read into tne à: 
tarzet address. Control then transrers * 
memtoe LOADER program for execution. ROM ~ 
@ contains the even memory locations, and* 
mom 1 contains tne oad addresses. BOOT * 
ROM uses RAM between VULLOVE and 7C 25 NU = 


(absolute) for a Scratch area. = 
IEIR IR IE K IK FE IK IRIE IE IR IR IR XE IE IE He AK AK CE ARASH IR FK IE FR FR IR IE XR KE FR KR FE IR IR IR XR FF XR 


IEAS AAR AS RRR NE AERE BE IK SA AS AR SR SE IR AS HT RE SE SE AR RIE RER SER E IE IR IR FE RE IE SE XR IR IE IR IR FR SE FE FE IR FE IR IR FA IR E AE K 
x 

This Customized ROM loader for CFE/M-E6 nas 7 
the following hardware configuration: m 
Processor: iSEC 86/12a > 

Disk Controller: Remex Data Warenouse "m 
OrSUtneoECEZUIS2UZ s 

Memory moċżełl: 30832 = 

x 

Erorramnmer: u MsLe Perry = 

FR AK HS FS FE AE AK I IRIS HE TK AK AE HK HE AK FE I HE HE FR HR A I AE BR AK AS HS AR OE AS BE IA NARA A AA A IA AA 






) 


. 
? 
. 
? 


we “we 


"9 "9 


LINE we we 


we we 


E AE SE RE BE RE IK AT AE IAS AES 36 XE RE KE R RAE AE EQUATES KEAR AR GE E RE SE AE AI AA AS ER RER HE 
x E 
ee oz) sc2 ll aneous eaustes- -=-=-- >= ==> E 
1 | 
I 1 

er equ £dE sAScii carriage return 

aisk type equ £1H Ta tOr R D E disx 

Jod equ £aH ‚Ascii line feed 

memex type eau KE Ntype for KEME st loopy 

romseg SquUy ot rica, base address 

sector size equ 128 ;CP/M sector size 
Start trkl EQUIICSA 

I 

l j 
nn. foe ok Ereonso le sports: == 
l ! 
| I 

CONP data SUUS UGS wes data port 

NONE Status equ tial ; 12251 status port 


Ez- Dist Controlier c 


DÉ cnkint mask equ 


ommand bytes 


V04H nasr 
CCSH ¿move 
LH ¿read 


and masks (iSBC 242) --- 


tor cegeck tom DE interupt 
koshnamer B0e1L)or command 


Command 


nora cmd agu 
DK_read_cmd equ 
l 
l 
E ee e INTEL 152C 


DKP_ base equ 
MRP iresult type equ 
eee result byte equ 
EXP reset equ 
DEP Status equ 
DEP iopb low SO 
DKP_iopb_nign equ 


eve Disk Con 


pH 

DEP Daseri 
DP baser 
DER basert 
DKP_base 
DKP_base+l 
DEP_base+2 


troller Ports ----------- 


! 
sctrler s base in CP/M-86 
‚onerarlan.zsesult type 
‚operatior result byte 
yaisk reset 
sdisx status 
slow adar üyté ofr iopb 
»snign addr byte of iopo 





geira cmail Syu 121iın Pega Or Chive 1 


IET ma SK egumen ;ready mask for control 

Corri err nask equ Lan PCONprorler error 

d err mask equ £8n ‚disk error 

erc err mask equ 1£n Jere error 

cmenseg equ deln ¡common memory 

tries equ 14 ‚number ot retriss 
. 1 ! 
, 1 | 
<5 0 00 Reo e LCR Er OL tS saan a SSS 
e | 1 
1 1 1 
ema reg equ "0n controller base 
Status reg equ Tin ¡status Tesis ter 
peaddr_ lo equ uon PIOWETL adgress 
peeddr ni equ on ‚upper address 
| 
, -e m e e e e e ee e e e o E a ee o E e A a a e e e e e e i es a ee m m wwe o we e ms e e e oe a 
: - INTEDAAS29o tonos rammablle Interrupt Controller ------= 
. 1 
) 1 | 
me 59pi equ econ 


x „e2esgarport 6 
PIC S9p2 equ ¿Cen „ezs9ospeorL. l 
; 1 1 


t 
7 RIERA ENTRY POINT AND MAIN COD 828365 E E 
H 


see  romsez 
H 
Mater nere with effa4:2 command for iSHC 242 boct 
H 


mov DL,disk type ‚seit DOOT type to diss 
Japs Start boot sg0 start coze 


H 
punter nere witn effd4:0004 command for REMEX toot 
) 


mov DOL remer type SECO LLE nto Fenex 
tart boot: 


move our data area into RAM av U0UL :12L4 


mov AX,CS POOL ue DS PO CS tor Source 
mov US AX 

mov SI,databegin pstartoopo cata 
MOVeDE,OLiSet ram start  ,;oftset ot destination 

mov AX,Z set dest segment (ES) 
mov ES,LA t TL 
mov CX,data_lenetn ;n 


ow much to move (bytes) 


un 





rep moves AL,AL 


we 99 9€ 


mov 


mov 
NOV 
mov 
cud 


"9 we we 


mov 
OUT 
TOV 
out 
nov 
out 
mov 
out 


* 


we we we Wt we 


ep DL,a1sz type 


jne 


por 1202: 


we we we bd wewe we 


in 
in 


Qui DE? "Teset.,Al 


"^9 a0 wo 


mov DK io com,DK nome cmd 


HEHE RE IKE AS IK IS IRAE OK 


determine if 


AL, E 


DS , AX 
SS, AZ 


set seenent registers and initialize 


SP,stack offset 


AL,U1SH 
PIC 59p1,AL 
AL, €1¢EH 
Pi Ges ope ,AL 
AC DIFE 
PECEIIDE , AL 
AL ee io 
PIC_59p2,AL 


boot remex 


RK KARR MAAK KR EKER 1S5 RO 202 


BRANCH TO SELECTED 


snowes- rom enrom, 
¡byte ata time 


Lec stack 


‚set DS segment to ECC, 
snow in RAM 
data segment Ow in RAM“ 


sinit Stack segment/pointer 


setup tne 2259 Programmable Interrupt Controller 


sclear the di GeeLilon tiae 
‚8259a ICW 1 8486 moce 
;89259a LOWNI2 vector @ 4¥-S?F 
382593 ICW 4 auto EOI master 
;8259a OCW 1 mask alli levels off 
DEVICE FOR ZEUUT en s abut at 
ZO OP DOCE 


Bocorins t0 1550 


Al DEP? result type 
ADE? result byte 


fome tne iSEC 2¢2 


Gack Execute Cima 


mov DÉ io com,DK read cm4 


peu trace 


"^8 “we. “eo 


DAS Sc tor 1; 


tne GENCML 


mov BX,ottset genneader 


nov DK_ama_addr,5X 


BOOT 


si SP ENS a 12727? 


pit enol, Coot to REMEX 
CODE 25 KAT AE IK SH RAT AT AS He 5,5 345 oS 3,5 AE AT SE aS FE AS 


return on fatal errors 


test and initialize tne iMDS 200 Disxetrte Interface 


selear the controller 


¿AL is dummy 
tor tais command 


loaa io command 
saome tne disk 
sall 1o now reads only 


neader record 


notftser tor 1st sector DUaA 
Store tama cdaress )n9ropb 


ics 





nova AS Ses tran, 1 
now gb esector ,i 
cali DK Execute Cmd 


Bn sUcpE sect 2-26. and 


we we we 


mov ES,abs location 
mov AX,ES 

mov CL,4é£ 

sal AX,CL 

mov D£_dma_adar,AX 
GVO oes tral, 25 
mov DM Sector, 
call DK Execute Cm4 


EB: trTK 1, sect 1-25, put 


we we we 


nov AX,ES 

Al Start Lrel 
mov CL,@4 

Sal AX, CL 

MOveuk ame adcr,Ax 
MOVED secs tran,2o 
Mov sbeosector, 1 

mov DK track,1 

call DK Execute Cmd 
naeuTmoRDomboader 


oot remerx: 
TOV AX,cmemsee 
nov ES,AX 


Bot again: 
Domi gr rd cmadl 
mov an,@¢n 
moval, TIn 
puson ax 
call buiid packet 
"all send packet 


mov di,offset genneader 


mov ax,ds 
Call ter Ole Ter 


wewe we we 


now e gbDse location 


Bouelodd location from GENCMD 


stranster 1 sector 
MS Car Uma SeCLOr stl 
read track €, Sector 1 


place in RAM 


;sSeezment loc for LOADER 
ILO AX TO manipulate 

¡Must rat. to 16-015 Adar 
„shift segment 

‚store dma address in iope? 
„trranster 25 sectors 
„start at sector #2 

stead Cre 0, 92015 2-20 


tener, place ın AM 


y»compure otfset tor track J 
ada in what already real 
THUS wliat to 16=01t. acdr 
Shift seemert 

Store dma dacress in 1000 
s;transrer 26 sectors 
„startsart .esecrtorsel 

Start at track #1 

read trek 1, serts 1-26 

En nass Control to loader 


HE TEAR AT KEK KAR KARR ROR RR KKK REMEX ROOT CODE NSSGENOGREXORROGRORGROR N E RIK E X 


ymake common memory 
‚adaressarle 


pet track E, sector 1, tne G&NCMD heaaer 


‚return nere or errors 

est uo to read drive 1 
stracx Q 

‚sector 1 

7S 
cA 
4 


SED destinatis 
¡Set up source 


neader 


sabs is location in RAM 
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nov CL,¢4 


POCORVETT. £0.16 01 


sal BX,CL ;BX now has load address 
nov DI, Bx snow in di 
get: 
popeax jECGUCHert sector 
inc al sand check for last 
empe4ai,co FON tots track 
qa fin-l 
get 1: 
push ax ‚save aX 
MOVEL aK ra cndi sprepare for read 
cami da. packet Ec nert Sector 
call send packet 
mov ex,V000n ‚absolute load 
call xter_bufrer 
jmp get 
mon 1: 
inc an „get next track? 
cnp an, 
ja Jump_To_Loader junpstöo loader 
mov al,l Peete ts Sec lor Murber 
dopeset 1 
IE SR IR SK IR IR SERE KE IK AR E NE FR AR PASS CONTROL TO LOADER IE RE XE A IE XE SK RE KE SR FE SRE SR IE AR XE XE 


we we 


Jump To Loader: 
mov ES aus location segment addr of LOADER 
mov leap Segment, As ‚load 
‚setup far jump vector 
mov cap offset. io iset of LOADER 
wM ore ptr leap offset 


se we 


EERE RK RRR RRR ES END OF MAIN COLE FREE ann 


y PERRA IKK OK IKI ERGINNING OF SUBROUTINES IRA IOR RIR IK I IE XE IE NK I MM N 


S TEIE AE RE SEAE DE AR FE RERE IR IE NE IE IR IE KIK AE FE IR FE SR REFR FR SE SR IR KEDE IE SE BEIE SE IE FE FR K ASIR AER AE AR RE AE IRAE ALAE AE E AA SR 
y” CONIN subroutine 
SERA REI KERE RE IERE RE IE SE HEE KE SE IE AE OK BE A AK AR AK MORE A AS A TR AE FE IN A OR IR ICE AER BK RE KESE FEKE KE FR IE SE FR 
;called from: Dk Execute Cmd. 
Conin: S returns Console KEydoaTrTd caaracter 
Late erie none 
ss Palm out = Feturns character in AL 
in AL,CONP status ;g@t status 
and AL,2 see lroreadv-Dlt l-is set 
ie Conia Pion Obata S Zero and not ready 
PieaeyeONr Gdta Treacy, so reed Cnharacter 
and AL,£7fH ¡remove parity Dit 


Ht 


> 
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REL 


IK IR AK IK IR IK IR IK IK IK IK IK IK IE FE AK AK IK AK OR AK IE FR SR IE IR IE IR XR IR IR IR IE IR IR IRIK FR IRIK IK FR IR IE IR IR IR FE IE KE IE AE IR FE IR IE XE IK 

* CONOUT subroutine = 

IK IK HK IK AK IK AK AK IK IK XE IK IE AE IK SK IK AK RE AS AE HS AK OK RAK IR IK IR AK AK AK AK IK IK FS AK AE IK SS AK ES SRS AS A HS OK HE ORK AK OK 

reallegsrrom, Print MSE. 

Conout: BES aWrErveg nıraerer to console Key 00ard. 
Er zparıelag-scheracevwerzstorce outbut In CL 
“= parm out = none 

E status set console status 


~<. WO WO we we 


and AL,1 ¡see if ready-bit Y-is set 

32 CONOUT pieecero, NOL teqdy-Keep checking 
mov Al, CL load input parm to AL Tor out 
out CONP data,AL ;output cnaracter to console 

wie 


IE IR IK IR FR XE IK IK IK IK IR XK SK IK IR HE SE XR IR IR IE IR IR IE IE IR IE FR IR IE IK IR IA XE FR SR S IE XE IR FR IR FK IR IR IE SR IR XR KE FR XR OK NK IR IÈ 


me 
2 DK EXECUTE CMD subroutine a 
HK TK IK HS IK AK AS IK A ARIK IK IK IK IK IK AK HK IK HK XE XE SE A AA A AI AE R IR IR IR AA AA RA NE AR ACOR 


we we BS we We ws We 


»ocudcdaenpomi in line trom 2901 1242. 
Brekrecutre Cma: ;** Executes a disk read/write command 
Dania DMA adar in El. 
ET Dar Tout. = none 
send aopo to disk controller via two ports (2 bytes) 
send iopb: 
IMS result type clear te controller 
result byte ‚clear the controller 
mov AX,ottset DK iope ;eet address of iopod 
ONE LO soutput low byte of lopo aadr 
move fib AH "losa high oy te to AL for output 
Cee Opp Nien,AL „out nren byte of lopb eidr 
zcneockeftore Dnterrupt from disx controlier 
Diss int: 
estatus iget disk status 
IA Den Dot masx interrupt set' 
ze Disk int Fl. TOG, Seep checking 
Poco ree otertupt Sigaifies 170 completion 
in AL,DKP_result_type ;zet reason for interrupt 
cnp AL, JBR ‚was I/O co plete ? 
iemoeewmeresult ir SO, £0 check the result byte 
Ingsmsenasjiopyt yif not, 20 try again 
neckeresult byte for errors 
karesult: 
Dee Beresult byte „getrresult cyte 
and AL, 382E sis 1/0 complete? 
Jazi ratal arTT OE?) tatal error 


ce 
Chez 


mon 





and AL,?feH yonecHtor empor in anv Bit 
JNE e cute Pet 50 Errors, go return 


Fatal_err: 


moveo bp FoeLeadreClevor COunteT 
tes te 
Cel ens 2 | scheck each bit of result 
ee ore scount each bit 
test AL,?1 test sach bit 
jz Ftest zero, £0 check next 
mov AL,CL ‚not zerosserror, ine Count 
mov AH,£ ‚clear nigh 
add AX,AX Wuosublescfor Lan vo word table 
mov BK,AX ;load BX as index 


mov BX,errtbi[{bx] ;get addr of error mse 


MOEINt appropriate error message 


C3 ll PAIRC MS write msg to console 
eda Cons 1 wwalt tor key strike 


p Soot 1222 then start all over 


Pree xecute ret: 


. 
) 
) 
D 
e. 
3, 
? 
. 
) 

S 


send 1: 


De 


BK IK IK A AK AK AK HE HK EA IK AE HE A IR IE IR IR XR E SR E HK AC AE XR AE R IR IEIR IR IE XE IE IR IE IR R RR AA AA a 
= REMEX seni_packet subroutine * 
BR ATH AT AT AT AT AS AS ASAT FE HE aT HE TE AS ASAE HT AT HSS He AS SE HK AS 3H SS SHE IT BES EAT AS AS OS HS OS aS BS aS AS ae AS OS RA E 25 


ead. packet: 


NOVAS Sd cnt, tries loed count tor retries 


in AL,status_reg 


and AL,dKk rdy mask Cece ıullertace ready 


exeresult: 


) 
cmp AL,@&n ‚ready? 
Inessengde] sift mot, Teneat 
mowsaLl,len ¡load extended address 
Ouwecma ree, AL 
mov AX, alén s pacet offset 
Out p addr_lo,aAl ‚transfer 10 byte 
Tov dl, an 
puspepEaddr 41,01 mupanstebpeint Oyte 
Do AX p Status ‚load status 
cnp 44,421 checa for success 
New sucecesoeread 
cnp AX,¢¢¢en ,OHee Genor, 1dai inure 
jne retry 


psc eres sul „not finished 


DON p Status, ¿član iclear status code 
dec ES:dk cnt ZIEL Ty mt 
goz send 1 

mov BXŽ,„,offset errtbl 





add EX,14 pee Just tor table entry 
mov BZ, [BX] 
gail Prievase 


call Conin ¡wait on user key strixe 
Jnp boot_again start over 
success read; 
H 
la f 
H 
t A 
y AS AEREA AA E RE KE IERE AR ARAS AK AK AE AK AE OR Be AE HE OE AR AE AK A FE BE HEI BK AE A A A AE A AR OR SDK AK AS IK IR I SE HE AE SEIE DE AE AE IR I 
H 
H 
A dada 
s REMEX  tuild packet  subroutine S 
TE RENE RAEE AURA SECUELAS REALE ALAS AE LAO LEIA ARCE TR AERC AS AE AE E SA SR AE RAE FE TA FR RE aa SE AR IR AR 


1 
bud packet: 


MOV Howp Modifiers, dx ¡Set edd Coce 

MOV FSi p Status, iclear Status, word 

nov dx,290060n ‚clear üx 

mov ál,an „set track number 

nom Bos 0 track no,dx Vente t so packet 

mov ax,¢@@vCn clear cx 

mov die. a PS5et Sector ard, head 

mov Hosp head Sect,72x renten in pakor 

Dove sepeneaksadr ,eldonzsscedress of tutíer 

mov §SS:p_msb,¢@¥en poucter msb 

MONITO Nord COUNT Of em snumcer of 16 birt wads 

Dot 
) ae at 
7 TR AE AE ARIK AE AK NE AE IK AK AE AK IK HE OE AE OK AE AK HE AK BK BE AR AE FE OK IK A RE AK I IE KE RE IR KE FE IR AX IR DE SIE DR KE E KE S OR OR AR OE OE AS AK OK FE 
$ RAR AR OS RE AE AS OH BRAS A BE AE AR AK AE ARE EEE MER IRAE IR FE R IK IK DE DK AX AX FE NE FE RE E A IX SE KE IE 3E FR FK FR A OE OK 
mr EAE —xver _ vuffer subroutine x 
S SK RAT HS FS AE 35 FS 3h 38 29S NEE KR REKEN RAR GE NA IF R EI NR AR N IR TG RI RN I RER RER AR ESS 
j 
Beer ouffer: 


pusn es!pusn as ‚save segment registers 
mov eS,ax ¡Set Up tor iralster 
TIV ax,cmemseg 

mov ds,ax 


nov Si,Z71££h ;:locatlonoot butter 
nov cx,64 ‚word count 
era ;clear direction flag 


rep movs AX,AX 
pop. as!pop es 
ret 


IR EIK IE IE IE IE IR RE XE IK IR XE IK KE IR IR FR IR IR IR FRIR IE RRIP IR IR SR IR XE IR IR FE IE IE IR IE KR IR FR FR FE IR KR IE FR XE FE AE IE KE XR XR S IK XE XK 


we we #®e we 


HE AE IE FES 3,5 3,8 5K AS 56 HS AS AE AS SS AE 3S BERS AS OS 3S AT AS SEAS BS 2s AS HT SHS AS FE AE AE 395 S18 36S AT AS 3,8 3,5 FS AS AS BK RS AS R IE SE AR E AE RRR R 
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;* PRINT MSG subroutine = 

g EFR HE HE HS KE FEIE IK IKIE KE NERE HR FE FIE SE E IE AE DE RE I RIE FE DE SR I IE E RE IE XE AE E IE KE KE IR E IEF FEDE KE IE REA ER XE AE HE OR D 
Called from: Dk Execurve mad. 

erint Msg: ;** Prints a message to tne censcle. 
;** parm in ~ address of message in BX. 
ESTE MOUSE 


moy CL, LEX] ‚get next char from message 
DesvecL,cL ‚is it zero —- end ot message ? 
jz Pmsg_ret ‚sit zero return 
push PX ¡save address of message 
ca COnont A o O 
pop BA ¡restore address of message 
ine EX ‚next character in message 
MPSS int se „next cnaracter and Loop 

rise ret: 
ret 


"9 we woe 


SRM ARE PND OF SUBROUTINES seat ater at ns ag as TEAS AE EAS NC OR AS KERE FE NE aE FE NE 


„Images ofr data to be moved to RAM 


1 

datanegin eyu offset $ 

, 

¡A template iSEC 202 iopb (channel command - 7 bytes) 
db ?2B8UE ‚iopb cnannel word 


db £ sio command 

dm v y»number of Sectors to xter 
db @ ‚track to read 

cb € ¡Sector to read 


iwe ClCH n dma addr Tor 12SEC 272 
»5nd of iopt 


cerrtbl dw ortfset erg 

dw offset eril 

aw offset er2 

dw offset ers 

d w offset er4 

dw offset er5 

dw orfset er6 

dw onset ery 
) 
Cerg db erlt. Null Sarrorz 0 
Deri ab Cott. ORC Error „9 
Cer2 db Grif, Seex Srror ,¢ 
Cer3 db rlf, “Address Error”,0 
Cer4 db cr,li,° Data Overrun-Underrun’ ,¢@ 
Cers db Grille. “rite Protect ,0 
Cer6 db ppc write Error ,¢ 
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Cer? db crf, Drivs Not Ready ð 
? 
dataend egu offset $ 


? 

data_lenetn equ dataend-databegin 
reserve space in RAM for data area 
(no hex records generated nere) 


We we "99 ~w 


DS EG g 
org C2erH 
, 
ram_start equ $ 


1 
;Tnis is tne iSBC 282 iopb (cnannel command - 7 bytes) 


DE_iopd eb: 1 ‚iopp channel word 
DE 10_com TDI il ‚io command 
BERsecs _tran Pon 1l where Ot Sectors to xfer 
Wee track POI ‚track to read 
DRT Sector moe 2 ¿Sector to read 
DK_dma_addr 7w 1 ¡ama addr tor 1580 2902 
mona ot iopd 
? 
Sn tD rw 3 
er? rt lengtn cerZ ILO 
erl rd lengtn ceri 
er2 ro lenetn cer2 
erg pb lenegtn cers 
er4 nb lenztn cer4 ‚14 
er5 RE lengtn cer5 ;11 
erg 2D Length cero nic 
ar Ib bene to cer? yl 
’ 
leap_orrset rw 1 
Heap segment TW 1 
? 
rw 52 Local Stack 
epaek offset egu offset S;stace trom nere down 
? 
‚128 byte Sector will be read in here-GENCMD reader 
genneader equ offset S 
ro 1 
rw 1 
aos. location rw Jeera csoO.ute losdg Location 
rw 1 
TW 1 


BEANE HE HK RE AK HC IE IK OK AK IK IR IE KEE KE KENE KE KE KE XE SE IE IE FE BE AE OK OS OK OS TE IK AK NE OK OS OE AK DK IE BETH IK OK XE NE SAOR ZK 


H 
q REMEX packet and data locations m 
S EFE KIR RE NE E NE IE BERE KE RE NE AE DR E BERE IE SE AE AE IE EI RE RE IE AE SEIE IE KE IE HE E DE SE D IE DIE NE IESE SE SR FR IR SK FE 


3 
x 
X 
3 
3t 
x 
A 


4 


d 
H 
x 
3 
A 
3l 
3 
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we 


ES EG 


org guven por rSel Of FEVER pecker 
pemodifiers EN l s unction and logic urit 
pestatus TW i PUCTUCRed es tatus 
pa TdCK no TW T Selected TTaCK nunmter 
p head sect rw 1 ; Selected Nead/sector number 
pemen addr rw 1 jtutrer address 
p_msb TW 1l nezxtengedebies ef 0UTTer addr 
p_word_count Tw 2 joizewor data locs 


org higner than buffer to be sure 


we we we 


org 550h 


ae cnt ric 1 ¡number retries 

y 

E E owe acne WRITS ETF E RE SE SE ER SEAE E RE AE R KEA AE NSE E RENE S, SE E OR AE Ae AC E 

1 S End of CP/M-&6 Customized ROM = 

MELLE EAE EAE E NEE NERE IE SE IE AE EA ARCAS SIS SIUS AS DE AE IE E AE A F oe Ae AB ee IE IE BAE SE On ue AS R NEN PEE 
END 


we 


Ja 





D$. 
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